Subscription usage resources
Applies to: Partner Center | Partner Center for Microsoft Cloud for US Government
You can use the following subscription usage resources to get usage information for a specific subscription with usage-based billing. These subscriptions have daily and monthly usage records, along with a usage summary for each pay period.
SubscriptionDailyUsageRecord
The SubscriptionDailyUsageRecord resource is obsolete and might produce inaccurate results. We recommend that you update your applications to use the APIs described in Get a customer's utilization records for Azure and Get prices for Microsoft Azure instead.
The SubscriptionDailyUsageRecord resource describes how much a subscription is used in a single day.
| Property | Type | Description |
|---|---|---|
| DateUsed | string | The day, in date-time format, that the subscription was used. |
| ResourceId | string | GUID. The unique ID of the resource. |
| ResourceName | string | The name of the resource. |
| TotalCost | decimal | The estimated total cost of using the resources in the subscription on the specified day. |
| CurrencyLocale | string | The locale in which the subscription was used, determines the currency to use on the invoice. |
| LastModifiedDate | string | The day, in date-time format, that this record was last modified. |
| Attributes | ResourceAttributes | The metadata attributes corresponding to the resource. |
SubscriptionMonthlyUsageRecord
The SubscriptionMonthlyUsageRecord resource describes how much a subscription is used in a single month.
| Property | Type | Description |
|---|---|---|
| Status | string | The status of the subscription: "none", "active", "suspended", or "deleted". |
| PartnerOnRecord | string | "The PartnerID of the partner on record." |
| OfferId | string | GUID. The ID of the offer related to this subscription. |
| Id | string | GUID. The ID of the subscription or resource. |
| Name | string | The name of the subscription or resource. |
| TotalCost | decimal | The estimated total cost of using the resources in the subscription in the specified month. |
| CurrencyLocale | string | The locale in which the subscription was used, determines the currency to use on the invoice. Available for Microsoft Azure (MS-AZR-0145P) subscriptions. |
| CurrencyCode | string | Gets or sets the currency code. Available for Azure plan subscription resources. |
| currencySymbol | string | The currency symbol used for all invoice item amounts and totals. |
| USDTotalCost | decimal | Gets or sets the estimated total cost in USD. Available for Azure plans. |
| LastModifiedDate | string | The day, in date-time format, that this record was last modified. |
| Attributes | ResourceAttributes | The metadata attributes corresponding to the resource. |
SubscriptionUsageSummary
The SubscriptionUsageSummary resource describes how much a specific subscription was used in the current billing period.
| Property | Type | Description |
|---|---|---|
| ResourceId | string | GUID. The ID of the subscription or resource. In the context of CustomerMonthlyUsageRecord, this ID is the customer ID. |
| ResourceName | string | The name of the subscription or resource. In the context of CustomerMonthlyUsageRecord, this name is the customer name. |
| BillingStartDate | date | The start date of the current billing period, in date-time format. |
| BillingEndDate | date | The end date of the current billing period, in date-time format. |
| TotalCost | double | The estimated total cost of using the resources in the subscription during the specified billing period. |
| CurrencyLocale | string | The locale in which the subscription was used, determines the currency to use on the invoice. Available for Microsoft Azure (MS-AZR-0145P) subscriptions. |
| CurrencyCode | string | Gets or sets the currency code. Available for Azure plans. |
| USDTotalCost | decimal | Gets or sets the estimated total cost in USD. Available for Azure plan subscription resources. |
| LastModifiedDate | string | The day, in date-time format, that this record was last modified. |
| Links | ResourceLinks | The resource links corresponding to the SubscriptionUsageSummary. |
| Attributes | ResourceAttributes | The metadata attributes corresponding to the SubscriptionUsageSummary. |