Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
oci.UsageProxy.getSubscriptionRewards
Explore with Pulumi AI
This data source provides the list of Subscription Rewards in Oracle Cloud Infrastructure Usage Proxy service.
Returns the list of rewards for a subscription ID.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testSubscriptionRewards = oci.UsageProxy.getSubscriptionRewards({
    subscriptionId: testSubscription.id,
    tenancyId: testTenancy.id,
});
import pulumi
import pulumi_oci as oci
test_subscription_rewards = oci.UsageProxy.get_subscription_rewards(subscription_id=test_subscription["id"],
    tenancy_id=test_tenancy["id"])
package main
import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/usageproxy"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := usageproxy.GetSubscriptionRewards(ctx, &usageproxy.GetSubscriptionRewardsArgs{
			SubscriptionId: testSubscription.Id,
			TenancyId:      testTenancy.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() => 
{
    var testSubscriptionRewards = Oci.UsageProxy.GetSubscriptionRewards.Invoke(new()
    {
        SubscriptionId = testSubscription.Id,
        TenancyId = testTenancy.Id,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.UsageProxy.UsageProxyFunctions;
import com.pulumi.oci.UsageProxy.inputs.GetSubscriptionRewardsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var testSubscriptionRewards = UsageProxyFunctions.getSubscriptionRewards(GetSubscriptionRewardsArgs.builder()
            .subscriptionId(testSubscription.id())
            .tenancyId(testTenancy.id())
            .build());
    }
}
variables:
  testSubscriptionRewards:
    fn::invoke:
      function: oci:UsageProxy:getSubscriptionRewards
      arguments:
        subscriptionId: ${testSubscription.id}
        tenancyId: ${testTenancy.id}
Using getSubscriptionRewards
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getSubscriptionRewards(args: GetSubscriptionRewardsArgs, opts?: InvokeOptions): Promise<GetSubscriptionRewardsResult>
function getSubscriptionRewardsOutput(args: GetSubscriptionRewardsOutputArgs, opts?: InvokeOptions): Output<GetSubscriptionRewardsResult>def get_subscription_rewards(filters: Optional[Sequence[GetSubscriptionRewardsFilter]] = None,
                             subscription_id: Optional[str] = None,
                             tenancy_id: Optional[str] = None,
                             opts: Optional[InvokeOptions] = None) -> GetSubscriptionRewardsResult
def get_subscription_rewards_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetSubscriptionRewardsFilterArgs]]]] = None,
                             subscription_id: Optional[pulumi.Input[str]] = None,
                             tenancy_id: Optional[pulumi.Input[str]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetSubscriptionRewardsResult]func GetSubscriptionRewards(ctx *Context, args *GetSubscriptionRewardsArgs, opts ...InvokeOption) (*GetSubscriptionRewardsResult, error)
func GetSubscriptionRewardsOutput(ctx *Context, args *GetSubscriptionRewardsOutputArgs, opts ...InvokeOption) GetSubscriptionRewardsResultOutput> Note: This function is named GetSubscriptionRewards in the Go SDK.
public static class GetSubscriptionRewards 
{
    public static Task<GetSubscriptionRewardsResult> InvokeAsync(GetSubscriptionRewardsArgs args, InvokeOptions? opts = null)
    public static Output<GetSubscriptionRewardsResult> Invoke(GetSubscriptionRewardsInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetSubscriptionRewardsResult> getSubscriptionRewards(GetSubscriptionRewardsArgs args, InvokeOptions options)
public static Output<GetSubscriptionRewardsResult> getSubscriptionRewards(GetSubscriptionRewardsArgs args, InvokeOptions options)
fn::invoke:
  function: oci:UsageProxy/getSubscriptionRewards:getSubscriptionRewards
  arguments:
    # arguments dictionaryThe following arguments are supported:
- SubscriptionId string
- The subscription ID for which rewards information is requested for.
- TenancyId string
- The OCID of the tenancy.
- Filters
List<GetSubscription Rewards Filter> 
- SubscriptionId string
- The subscription ID for which rewards information is requested for.
- TenancyId string
- The OCID of the tenancy.
- Filters
[]GetSubscription Rewards Filter 
- subscriptionId String
- The subscription ID for which rewards information is requested for.
- tenancyId String
- The OCID of the tenancy.
- filters
List<GetSubscription Rewards Filter> 
- subscriptionId string
- The subscription ID for which rewards information is requested for.
- tenancyId string
- The OCID of the tenancy.
- filters
GetSubscription Rewards Filter[] 
- subscription_id str
- The subscription ID for which rewards information is requested for.
- tenancy_id str
- The OCID of the tenancy.
- filters
Sequence[GetSubscription Rewards Filter] 
- subscriptionId String
- The subscription ID for which rewards information is requested for.
- tenancyId String
- The OCID of the tenancy.
- filters List<Property Map>
getSubscriptionRewards Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- RewardCollections List<GetSubscription Rewards Reward Collection> 
- The list of reward_collection.
- SubscriptionId string
- The entitlement ID from MQS, which is the same as the subcription ID.
- TenancyId string
- The OCID of the target tenancy.
- Filters
List<GetSubscription Rewards Filter> 
- Id string
- The provider-assigned unique ID for this managed resource.
- RewardCollections []GetSubscription Rewards Reward Collection 
- The list of reward_collection.
- SubscriptionId string
- The entitlement ID from MQS, which is the same as the subcription ID.
- TenancyId string
- The OCID of the target tenancy.
- Filters
[]GetSubscription Rewards Filter 
- id String
- The provider-assigned unique ID for this managed resource.
- rewardCollections List<GetSubscription Rewards Reward Collection> 
- The list of reward_collection.
- subscriptionId String
- The entitlement ID from MQS, which is the same as the subcription ID.
- tenancyId String
- The OCID of the target tenancy.
- filters
List<GetSubscription Rewards Filter> 
- id string
- The provider-assigned unique ID for this managed resource.
- rewardCollections GetSubscription Rewards Reward Collection[] 
- The list of reward_collection.
- subscriptionId string
- The entitlement ID from MQS, which is the same as the subcription ID.
- tenancyId string
- The OCID of the target tenancy.
- filters
GetSubscription Rewards Filter[] 
- id str
- The provider-assigned unique ID for this managed resource.
- reward_collections Sequence[GetSubscription Rewards Reward Collection] 
- The list of reward_collection.
- subscription_id str
- The entitlement ID from MQS, which is the same as the subcription ID.
- tenancy_id str
- The OCID of the target tenancy.
- filters
Sequence[GetSubscription Rewards Filter] 
- id String
- The provider-assigned unique ID for this managed resource.
- rewardCollections List<Property Map>
- The list of reward_collection.
- subscriptionId String
- The entitlement ID from MQS, which is the same as the subcription ID.
- tenancyId String
- The OCID of the target tenancy.
- filters List<Property Map>
Supporting Types
GetSubscriptionRewardsFilter   
GetSubscriptionRewardsRewardCollection    
- Items
List<GetSubscription Rewards Reward Collection Item> 
- The monthly summary of rewards.
- Items
[]GetSubscription Rewards Reward Collection Item 
- The monthly summary of rewards.
- items
List<GetSubscription Rewards Reward Collection Item> 
- The monthly summary of rewards.
- items
GetSubscription Rewards Reward Collection Item[] 
- The monthly summary of rewards.
- items
Sequence[GetSubscription Rewards Reward Collection Item] 
- The monthly summary of rewards.
- items List<Property Map>
- The monthly summary of rewards.
GetSubscriptionRewardsRewardCollectionItem     
- Items
List<GetSubscription Rewards Reward Collection Item Item> 
- The monthly summary of rewards.
- Summaries
List<GetSubscription Rewards Reward Collection Item Summary> 
- The overall monthly reward summary.
- Items
[]GetSubscription Rewards Reward Collection Item Item 
- The monthly summary of rewards.
- Summaries
[]GetSubscription Rewards Reward Collection Item Summary 
- The overall monthly reward summary.
- items
List<GetSubscription Rewards Reward Collection Item Item> 
- The monthly summary of rewards.
- summaries
List<GetSubscription Rewards Reward Collection Item Summary> 
- The overall monthly reward summary.
- items
GetSubscription Rewards Reward Collection Item Item[] 
- The monthly summary of rewards.
- summaries
GetSubscription Rewards Reward Collection Item Summary[] 
- The overall monthly reward summary.
- items
Sequence[GetSubscription Rewards Reward Collection Item Item] 
- The monthly summary of rewards.
- summaries
Sequence[GetSubscription Rewards Reward Collection Item Summary] 
- The overall monthly reward summary.
- items List<Property Map>
- The monthly summary of rewards.
- summaries List<Property Map>
- The overall monthly reward summary.
GetSubscriptionRewardsRewardCollectionItemItem      
- AvailableRewards double
- The number of rewards available for a specific usage period.
- EarnedRewards double
- The number of rewards earned for the specific usage period.
- EligibleUsage doubleAmount 
- The eligible usage amount for the usage period.
- IneligibleUsage doubleAmount 
- The ineligible usage amount for the usage period.
- IsManual bool
- The boolean parameter to indicate whether or not the available rewards are manually posted.
- RedeemedRewards double
- The number of rewards redeemed for a specific month.
- TimeRewards stringEarned 
- The date and time when rewards accrue.
- TimeRewards stringExpired 
- The date and time when rewards expire.
- TimeUsage stringEnded 
- The end date and time for the usage period.
- TimeUsage stringStarted 
- The start date and time for the usage period.
- UsageAmount double
- The usage amount for the usage period.
- UsagePeriod stringKey 
- The usage period ID.
- AvailableRewards float64
- The number of rewards available for a specific usage period.
- EarnedRewards float64
- The number of rewards earned for the specific usage period.
- EligibleUsage float64Amount 
- The eligible usage amount for the usage period.
- IneligibleUsage float64Amount 
- The ineligible usage amount for the usage period.
- IsManual bool
- The boolean parameter to indicate whether or not the available rewards are manually posted.
- RedeemedRewards float64
- The number of rewards redeemed for a specific month.
- TimeRewards stringEarned 
- The date and time when rewards accrue.
- TimeRewards stringExpired 
- The date and time when rewards expire.
- TimeUsage stringEnded 
- The end date and time for the usage period.
- TimeUsage stringStarted 
- The start date and time for the usage period.
- UsageAmount float64
- The usage amount for the usage period.
- UsagePeriod stringKey 
- The usage period ID.
- availableRewards Double
- The number of rewards available for a specific usage period.
- earnedRewards Double
- The number of rewards earned for the specific usage period.
- eligibleUsage DoubleAmount 
- The eligible usage amount for the usage period.
- ineligibleUsage DoubleAmount 
- The ineligible usage amount for the usage period.
- isManual Boolean
- The boolean parameter to indicate whether or not the available rewards are manually posted.
- redeemedRewards Double
- The number of rewards redeemed for a specific month.
- timeRewards StringEarned 
- The date and time when rewards accrue.
- timeRewards StringExpired 
- The date and time when rewards expire.
- timeUsage StringEnded 
- The end date and time for the usage period.
- timeUsage StringStarted 
- The start date and time for the usage period.
- usageAmount Double
- The usage amount for the usage period.
- usagePeriod StringKey 
- The usage period ID.
- availableRewards number
- The number of rewards available for a specific usage period.
- earnedRewards number
- The number of rewards earned for the specific usage period.
- eligibleUsage numberAmount 
- The eligible usage amount for the usage period.
- ineligibleUsage numberAmount 
- The ineligible usage amount for the usage period.
- isManual boolean
- The boolean parameter to indicate whether or not the available rewards are manually posted.
- redeemedRewards number
- The number of rewards redeemed for a specific month.
- timeRewards stringEarned 
- The date and time when rewards accrue.
- timeRewards stringExpired 
- The date and time when rewards expire.
- timeUsage stringEnded 
- The end date and time for the usage period.
- timeUsage stringStarted 
- The start date and time for the usage period.
- usageAmount number
- The usage amount for the usage period.
- usagePeriod stringKey 
- The usage period ID.
- available_rewards float
- The number of rewards available for a specific usage period.
- earned_rewards float
- The number of rewards earned for the specific usage period.
- eligible_usage_ floatamount 
- The eligible usage amount for the usage period.
- ineligible_usage_ floatamount 
- The ineligible usage amount for the usage period.
- is_manual bool
- The boolean parameter to indicate whether or not the available rewards are manually posted.
- redeemed_rewards float
- The number of rewards redeemed for a specific month.
- time_rewards_ strearned 
- The date and time when rewards accrue.
- time_rewards_ strexpired 
- The date and time when rewards expire.
- time_usage_ strended 
- The end date and time for the usage period.
- time_usage_ strstarted 
- The start date and time for the usage period.
- usage_amount float
- The usage amount for the usage period.
- usage_period_ strkey 
- The usage period ID.
- availableRewards Number
- The number of rewards available for a specific usage period.
- earnedRewards Number
- The number of rewards earned for the specific usage period.
- eligibleUsage NumberAmount 
- The eligible usage amount for the usage period.
- ineligibleUsage NumberAmount 
- The ineligible usage amount for the usage period.
- isManual Boolean
- The boolean parameter to indicate whether or not the available rewards are manually posted.
- redeemedRewards Number
- The number of rewards redeemed for a specific month.
- timeRewards StringEarned 
- The date and time when rewards accrue.
- timeRewards StringExpired 
- The date and time when rewards expire.
- timeUsage StringEnded 
- The end date and time for the usage period.
- timeUsage StringStarted 
- The start date and time for the usage period.
- usageAmount Number
- The usage amount for the usage period.
- usagePeriod StringKey 
- The usage period ID.
GetSubscriptionRewardsRewardCollectionItemSummary      
- Currency string
- The currency unit for the reward amount.
- RedemptionCode string
- The redemption code used in the Billing Center during the reward redemption process.
- RewardsRate double
- The current Rewards percentage in decimal format.
- SubscriptionId string
- The subscription ID for which rewards information is requested for.
- TenancyId string
- The OCID of the tenancy.
- TotalRewards doubleAvailable 
- The total number of available rewards for a given subscription ID.
- Currency string
- The currency unit for the reward amount.
- RedemptionCode string
- The redemption code used in the Billing Center during the reward redemption process.
- RewardsRate float64
- The current Rewards percentage in decimal format.
- SubscriptionId string
- The subscription ID for which rewards information is requested for.
- TenancyId string
- The OCID of the tenancy.
- TotalRewards float64Available 
- The total number of available rewards for a given subscription ID.
- currency String
- The currency unit for the reward amount.
- redemptionCode String
- The redemption code used in the Billing Center during the reward redemption process.
- rewardsRate Double
- The current Rewards percentage in decimal format.
- subscriptionId String
- The subscription ID for which rewards information is requested for.
- tenancyId String
- The OCID of the tenancy.
- totalRewards DoubleAvailable 
- The total number of available rewards for a given subscription ID.
- currency string
- The currency unit for the reward amount.
- redemptionCode string
- The redemption code used in the Billing Center during the reward redemption process.
- rewardsRate number
- The current Rewards percentage in decimal format.
- subscriptionId string
- The subscription ID for which rewards information is requested for.
- tenancyId string
- The OCID of the tenancy.
- totalRewards numberAvailable 
- The total number of available rewards for a given subscription ID.
- currency str
- The currency unit for the reward amount.
- redemption_code str
- The redemption code used in the Billing Center during the reward redemption process.
- rewards_rate float
- The current Rewards percentage in decimal format.
- subscription_id str
- The subscription ID for which rewards information is requested for.
- tenancy_id str
- The OCID of the tenancy.
- total_rewards_ floatavailable 
- The total number of available rewards for a given subscription ID.
- currency String
- The currency unit for the reward amount.
- redemptionCode String
- The redemption code used in the Billing Center during the reward redemption process.
- rewardsRate Number
- The current Rewards percentage in decimal format.
- subscriptionId String
- The subscription ID for which rewards information is requested for.
- tenancyId String
- The OCID of the tenancy.
- totalRewards NumberAvailable 
- The total number of available rewards for a given subscription ID.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the ociTerraform Provider.