Usage Details - List

列出已定義範圍的使用量詳細資料。 使用方式詳細資料僅適用于2014或更新版本的5月1日或之後的 API。 如需使用此 API 的詳細資訊,包括如何指定日期範圍,請參閱: https://docs.microsoft.com/en-us/azure/cost-management-billing/costs/manage-automation

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?$expand={$expand}&$filter={$filter}&$skiptoken={$skiptoken}&$top={$top}&api-version=2019-10-01&metric={metric}

URI 參數

Name In Required Type Description
scope
path True
  • string

與使用狀況詳細資料作業相關聯的範圍。 這包括訂用帳戶範圍的 '/subscriptions/{subscriptionId}/'、計費帳戶範圍的 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId} '、部門範圍的 '/providers/Microsoft.Billing/departments/{departmentId} '、適用于 EnrollmentAccount 領域的 '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId} ',以及管理群組範圍的 '/providers/Microsoft.Management/managementGroups/{managementGroupId} '。 針對訂用帳戶、計費帳戶、部門、註冊帳戶和管理群組,您也可以使用 '/providers/Microsoft.Billing/billingPeriods/{billingPeriodName} ' 將計費週期新增至範圍。 例如,若要指定部門範圍的計費期間,請使用 '/providers/Microsoft.Billing/departments/{departmentId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName} '。 此外,新式商務帳戶範圍是 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId} ' (適用于 billingAccount 範圍)、'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} ' (billingProfile 範圍)、' providers/Microsoft. 帳務/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId} ' (適用于 invoiceSection 範圍)和 ' providers/Microsoft. 帳務/billingAccounts/{billingAccountId}/customers/{customerId} ' (適用于合作夥伴

api-version
query True
  • string

要搭配用戶端要求使用的 API 版本。 目前的版本為2019-10-01。

$expand
query
  • string

可以用來在使用方式詳細資料清單中展開 properties/additionalInfo 或 properties/meterDetails。 依預設,列出使用狀況詳細資料時不會包含這些欄位。

$filter
query
  • string

可以用來依屬性/resourceGroup、properties/instanceName、properties/resourceId、properties/chargeType、properties/reservationId、properties/publisherType 或標記來篩選 usageDetails。 篩選準則支援 ' eq '、' lt '、' gt '、' le '、' ge ' 和 ' and '。 它目前不支援 ' ne '、' or ' 或 ' not '。 標記篩選是索引鍵值組字串,其中索引鍵和值是以冒號 (: ) 分隔。 PublisherType 篩選器接受 azure 和 marketplace 兩個值,且目前支援 Web Direct 供應專案類型

$skiptoken
query
  • string

只有在先前的作業傳回部分結果時,才會使用 Skiptoken。 如果先前的回應包含 nextLink 元素,nextLink 元素的值將會包含 skiptoken 參數,以指定要用於後續呼叫的起點。

$top
query
  • integer
int32

可用來將結果數目限制為最近 N 個 usageDetails。

metric
query

允許選取不同類型的成本/使用量記錄。

回應

Name Type Description
200 OK

正常。 要求成功。

Other Status Codes

描述作業為何失敗的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模擬您的使用者帳戶

範例

BillingAccountUsageDetailsList-Legacy
BillingAccountUsageDetailsList-Modern
BillingAccountUsageDetailsListForBillingPeriod-Legacy
BillingProfileUsageDetailsList-Modern
CustomerUsageDetailsList-Modern
DepartmentUsageDetailsList-Legacy
DepartmentUsageDetailsListForBillingPeriod-Legacy
EnrollmentAccountUsageDetailsList-Legacy
EnrollmentAccountUsageDetailsListForBillingPeriod-Legacy
InvoiceSectionUsageDetailsList-Modern
ManagementGroupUsageDetailsList-Legacy
ManagementGroupUsageDetailsListForBillingPeriod-Legacy
UsageDetailsExpand-Legacy
UsageDetailsList-Legacy
UsageDetailsListByMetricActualCost-Legacy
UsageDetailsListByMetricAmortizedCost-Legacy
UsageDetailsListByMetricUsage-Legacy
UsageDetailsListFilterByTag-Legacy
UsageDetailsListForBillingPeriod-Legacy

BillingAccountUsageDetailsList-Legacy

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.7329,
        "effectivePrice": 0.000402776395232,
        "cost": 0.000295194820065,
        "unitPrice": 4.38,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

BillingAccountUsageDetailsList-Modern

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "modern",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "1234:56789",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-10-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-10-31T00:00:00.0000000Z",
        "billingProfileId": "2468",
        "billingProfileName": "Account Name 1",
        "subscriptionGuid": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-10-30T00:00:00.0000000Z",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "quantity": 0.7329,
        "unitPrice": 4.38,
        "billingCurrencyCode": "USD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "instanceName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "invoiceSectionId": "98765",
        "invoiceSectionName": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage",
        "additionalInfo": "{  \"UsageType\": \"ComputeHR\",  \"ImageType\": \"Windows Client BYOL\",  \"ServiceType\": \"Standard_D1\",  \"VMName\": null,  \"VMProperties\": null,  \"VCPUs\": 1,  \"CPUs\": 0}",
        "costInBillingCurrency": 1.84763819095477,
        "costInPricingCurrency": 1.84763819095477,
        "exchangeRate": "1",
        "exchangeRateDate": "2019-10-01T00:00:00Z",
        "invoiceId": "",
        "previousInvoiceId": "",
        "pricingCurrencyCode": "USD",
        "product": "Virtual Machines D Series - D1 - US East",
        "productIdentifier": "DZH318Z0BQ4B00FV",
        "productOrderId": "a3db7880-70eb-4b4c-6a79-1425a058df5a",
        "productOrderName": "Azure plan",
        "publisherName": "Microsoft",
        "publisherType": "1PP",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-10-01T00:00:00Z",
        "customerTenantId": "00000000-0000-0000-0000-000000000000",
        "customerName": "Modern Azure Customer 1",
        "partnerTenantId": "00000000-0000-0000-0000-000000000000",
        "partnerName": "Partner Name 1",
        "resellerMpnId": "",
        "resellerName": "Reseller Name 1",
        "publisherId": "",
        "reservationId": "",
        "reservationName": "",
        "frequency": "UsageBased",
        "term": "",
        "marketPrice": 0.077,
        "costInUSD": 1.84763819095477,
        "paygCostInBillingCurrency": 1.848,
        "paygCostInUSD": 1.848,
        "exchangeRatePricingToBilling": 0.077,
        "partnerEarnedCreditRate": 0.077,
        "partnerEarnedCreditApplied": "0"
      }
    }
  ]
}

BillingAccountUsageDetailsListForBillingPeriod-Legacy

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.8234,
        "effectivePrice": 0.010534556373432,
        "cost": 0.000342194841184,
        "unitPrice": 3.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

BillingProfileUsageDetailsList-Modern

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/billingProfiles/2468/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/billingProfiles/2468/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "modern",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "1234:56789",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-10-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-10-31T00:00:00.0000000Z",
        "billingProfileId": "2468",
        "billingProfileName": "Account Name 1",
        "subscriptionGuid": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-10-30T00:00:00.0000000Z",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "quantity": 0.7329,
        "unitPrice": 4.38,
        "billingCurrencyCode": "USD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "instanceName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "invoiceSectionId": "98765",
        "invoiceSectionName": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage",
        "additionalInfo": "{  \"UsageType\": \"ComputeHR\",  \"ImageType\": \"Windows Client BYOL\",  \"ServiceType\": \"Standard_D1\",  \"VMName\": null,  \"VMProperties\": null,  \"VCPUs\": 1,  \"CPUs\": 0}",
        "costInBillingCurrency": 1.84763819095477,
        "costInPricingCurrency": 1.84763819095477,
        "exchangeRate": "1",
        "exchangeRateDate": "2019-10-01T00:00:00Z",
        "invoiceId": "",
        "previousInvoiceId": "",
        "pricingCurrencyCode": "USD",
        "product": "Virtual Machines D Series - D1 - US East",
        "productIdentifier": "DZH318Z0BQ4B00FV",
        "productOrderId": "a3db7880-70eb-4b4c-6a79-1425a058df5a",
        "productOrderName": "Azure plan",
        "publisherName": "Microsoft",
        "publisherType": "1PP",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-10-01T00:00:00Z",
        "customerTenantId": "00000000-0000-0000-0000-000000000000",
        "customerName": "Modern Azure Customer 1",
        "partnerTenantId": "00000000-0000-0000-0000-000000000000",
        "partnerName": "Partner Name 1",
        "resellerMpnId": "",
        "resellerName": "Reseller Name 1",
        "publisherId": "",
        "reservationId": "",
        "reservationName": "",
        "frequency": "UsageBased",
        "term": "",
        "marketPrice": 0.077,
        "costInUSD": 1.84763819095477,
        "paygCostInBillingCurrency": 1.848,
        "paygCostInUSD": 1.848,
        "exchangeRatePricingToBilling": 0.077,
        "partnerEarnedCreditRate": 0.077,
        "partnerEarnedCreditApplied": "0"
      }
    }
  ]
}

CustomerUsageDetailsList-Modern

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/customers/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/customers/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "modern",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "1234:56789",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-10-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-10-31T00:00:00.0000000Z",
        "billingProfileId": "2468",
        "billingProfileName": "Account Name 1",
        "subscriptionGuid": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-10-30T00:00:00.0000000Z",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "quantity": 0.7329,
        "unitPrice": 4.38,
        "billingCurrencyCode": "USD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "instanceName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "invoiceSectionId": "98765",
        "invoiceSectionName": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage",
        "additionalInfo": "{  \"UsageType\": \"ComputeHR\",  \"ImageType\": \"Windows Client BYOL\",  \"ServiceType\": \"Standard_D1\",  \"VMName\": null,  \"VMProperties\": null,  \"VCPUs\": 1,  \"CPUs\": 0}",
        "costInBillingCurrency": 1.84763819095477,
        "costInPricingCurrency": 1.84763819095477,
        "exchangeRate": "1",
        "exchangeRateDate": "2019-10-01T00:00:00Z",
        "invoiceId": "",
        "previousInvoiceId": "",
        "pricingCurrencyCode": "USD",
        "product": "Virtual Machines D Series - D1 - US East",
        "productIdentifier": "DZH318Z0BQ4B00FV",
        "productOrderId": "a3db7880-70eb-4b4c-6a79-1425a058df5a",
        "productOrderName": "Azure plan",
        "publisherName": "Microsoft",
        "publisherType": "1PP",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-10-01T00:00:00Z",
        "customerTenantId": "00000000-0000-0000-0000-000000000000",
        "customerName": "Modern Azure Customer 1",
        "partnerTenantId": "00000000-0000-0000-0000-000000000000",
        "partnerName": "Partner Name 1",
        "resellerMpnId": "",
        "resellerName": "Reseller Name 1",
        "publisherId": "",
        "reservationId": "",
        "reservationName": "",
        "frequency": "UsageBased",
        "term": "",
        "marketPrice": 0.077,
        "costInUSD": 1.84763819095477,
        "paygCostInBillingCurrency": 1.848,
        "paygCostInUSD": 1.848,
        "exchangeRatePricingToBilling": 0.077,
        "partnerEarnedCreditRate": 0.077,
        "partnerEarnedCreditApplied": "0"
      }
    }
  ]
}

DepartmentUsageDetailsList-Legacy

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/Departments/1234/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/Departments/1234/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.7329,
        "effectivePrice": 0.000402776395232,
        "cost": 0.000295194820065,
        "unitPrice": 4.38,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

DepartmentUsageDetailsListForBillingPeriod-Legacy

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/Departments/1234/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/Departments/1234/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.8234,
        "effectivePrice": 0.010534556373432,
        "cost": 0.000342194841184,
        "unitPrice": 3.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

EnrollmentAccountUsageDetailsList-Legacy

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/EnrollmentAccounts/1234/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/EnrollmentAccounts/1234/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.7329,
        "effectivePrice": 0.000402776395232,
        "cost": 0.000295194820065,
        "unitPrice": 4.38,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

EnrollmentAccountUsageDetailsListForBillingPeriod-Legacy

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/EnrollmentAccounts/1234/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/EnrollmentAccounts/1234/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.8234,
        "effectivePrice": 0.010534556373432,
        "cost": 0.000342194841184,
        "unitPrice": 3.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

InvoiceSectionUsageDetailsList-Modern

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/invoiceSections/98765/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/invoiceSections/98765/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "modern",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "1234:56789",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-10-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-10-31T00:00:00.0000000Z",
        "billingProfileId": "2468",
        "billingProfileName": "Account Name 1",
        "subscriptionGuid": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-10-30T00:00:00.0000000Z",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "quantity": 0.7329,
        "unitPrice": 4.38,
        "billingCurrencyCode": "USD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "instanceName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "invoiceSectionId": "98765",
        "invoiceSectionName": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage",
        "additionalInfo": "{  \"UsageType\": \"ComputeHR\",  \"ImageType\": \"Windows Client BYOL\",  \"ServiceType\": \"Standard_D1\",  \"VMName\": null,  \"VMProperties\": null,  \"VCPUs\": 1,  \"CPUs\": 0}",
        "costInBillingCurrency": 1.84763819095477,
        "costInPricingCurrency": 1.84763819095477,
        "exchangeRate": "1",
        "exchangeRateDate": "2019-10-01T00:00:00Z",
        "invoiceId": "",
        "previousInvoiceId": "",
        "pricingCurrencyCode": "USD",
        "product": "Virtual Machines D Series - D1 - US East",
        "productIdentifier": "DZH318Z0BQ4B00FV",
        "productOrderId": "a3db7880-70eb-4b4c-6a79-1425a058df5a",
        "productOrderName": "Azure plan",
        "publisherName": "Microsoft",
        "publisherType": "1PP",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-10-01T00:00:00Z",
        "customerTenantId": "00000000-0000-0000-0000-000000000000",
        "customerName": "Modern Azure Customer 1",
        "partnerTenantId": "00000000-0000-0000-0000-000000000000",
        "partnerName": "Partner Name 1",
        "resellerMpnId": "",
        "resellerName": "Reseller Name 1",
        "publisherId": "",
        "reservationId": "",
        "reservationName": "",
        "frequency": "UsageBased",
        "term": "",
        "marketPrice": 0.077,
        "costInUSD": 1.84763819095477,
        "paygCostInBillingCurrency": 1.848,
        "paygCostInUSD": 1.848,
        "exchangeRatePricingToBilling": 0.077,
        "partnerEarnedCreditRate": 0.077,
        "partnerEarnedCreditApplied": "0"
      }
    }
  ]
}

ManagementGroupUsageDetailsList-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.8234,
        "effectivePrice": 0.010534556373432,
        "cost": 0.000342194841184,
        "unitPrice": 3.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    },
    {
      "id": "/scope/providers/Microsoft.Billing/billingPeriods/20180801/providers/Microsoft.Consumption/usageDetails/usageDetails_Id2",
      "name": "usageDetails_Id2",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 2",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 2",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 2",
        "partNumber": "Part Number 2",
        "meterId": "11111111-1111-1111-1111-111111111111",
        "meterDetails": null,
        "quantity": 0.7329,
        "effectivePrice": 0.000402776395232,
        "cost": 0.000295194820065,
        "unitPrice": 4.38,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 2/providers/Microsoft.Storage/storageAccounts/Resource Name 2",
        "resourceName": "Resource Name 2",
        "invoiceSection": "Invoice Section 2",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 2",
        "offerId": "Offer Id 2",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

ManagementGroupUsageDetailsListForBillingPeriod-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.8234,
        "effectivePrice": 0.010534556373432,
        "cost": 0.000342194841184,
        "unitPrice": 3.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    },
    {
      "id": "/scope/providers/Microsoft.Billing/billingPeriods/billingPeriodName/providers/Microsoft.Consumption/usageDetails/usageDetails_Id2",
      "name": "usageDetails_Id2",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 2",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 2",
        "accountName": "Account Name 2",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 2",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 2",
        "partNumber": "Part Number 2",
        "meterId": "11111111-1111-1111-1111-111111111111",
        "meterDetails": null,
        "quantity": 0.4759,
        "effectivePrice": 0.073488920944598,
        "cost": 0.000821821271948,
        "unitPrice": 5.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 2/providers/Microsoft.Storage/storageAccounts/Resource Name 2",
        "resourceName": "Resource Name 2",
        "invoiceSection": "Invoice Section 2",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 2",
        "offerId": "Offer Id 2",
        "isAzureCreditEligible": false,
        "chargeType": "UnusedReservation"
      }
    }
  ]
}

UsageDetailsExpand-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?$expand=meterDetails,additionalInfo&$filter=tags eq 'dev:tools'&$top=1&api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": {
          "meterName": "Data Transfer Out (GB)",
          "meterCategory": "Networking",
          "meterSubCategory": "ExpressRoute",
          "unitOfMeasure": "GB",
          "serviceFamily": "Compute"
        },
        "quantity": 0.8234,
        "effectivePrice": 0.010464556322455,
        "cost": 0.000342194841184,
        "unitPrice": 3.54,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage",
        "frequency": "UsageBased",
        "additionalInfo": "{\"MyType\":\"\",\"ServiceType\":\"\",\"VMName\":\"\",\"UsageType\":\"MyUsage\"}"
      }
    }
  ]
}

UsageDetailsList-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Customer Name 1",
        "billingPeriodStartDate": "2019-04-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-04-30T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Customer Name 1",
        "accountName": "AccountName",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "SubscriptionName 1",
        "date": "2019-04-09T00:00:00.0000000Z",
        "product": "Product1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 3.6E-05,
        "effectivePrice": 0.054693034210767,
        "cost": 1.980949998E-06,
        "unitPrice": 5.47,
        "billingCurrency": "CAD",
        "resourceLocation": "uswest",
        "consumedService": "Microsoft.ClassicStorage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource-Group-westus/providers/Microsoft.ClassicStorage/storageAccounts/ResourceName1",
        "resourceName": "ResourceName1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "BAS",
        "resourceGroup": "Resource-Group-westus",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage",
        "frequency": "UsageBased"
      }
    }
  ]
}

UsageDetailsListByMetricActualCost-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01&metric=actualcost

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Customer Name 1",
        "billingPeriodStartDate": "2019-04-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-04-30T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Customer Name 1",
        "accountName": "AccountName",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "SubscriptionName 1",
        "date": "2019-04-09T00:00:00.0000000Z",
        "product": "Product1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 3.6E-05,
        "effectivePrice": 0.054693055510767,
        "cost": 1.968949998E-06,
        "unitPrice": 5.47,
        "billingCurrency": "CAD",
        "resourceLocation": "uswest",
        "consumedService": "Microsoft.ClassicStorage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource-Group-westus/providers/Microsoft.ClassicStorage/storageAccounts/ResourceName1",
        "resourceName": "ResourceName1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "BAS",
        "resourceGroup": "Resource-Group-westus",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

UsageDetailsListByMetricAmortizedCost-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01&metric=amortizedcost

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Customer Name 1",
        "billingPeriodStartDate": "2019-04-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-04-30T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Customer Name 1",
        "accountName": "AccountName",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "SubscriptionName 1",
        "date": "2019-04-09T00:00:00.0000000Z",
        "product": "Product1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 3.6E-05,
        "effectivePrice": 0.054693055510767,
        "cost": 1.968949998E-06,
        "unitPrice": 5.47,
        "billingCurrency": "CAD",
        "resourceLocation": "uswest",
        "consumedService": "Microsoft.ClassicStorage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource-Group-westus/providers/Microsoft.ClassicStorage/storageAccounts/ResourceName1",
        "resourceName": "ResourceName1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "BAS",
        "resourceGroup": "Resource-Group-westus",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage",
        "frequency": "UsageBased"
      }
    }
  ]
}

UsageDetailsListByMetricUsage-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01&metric=usage

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Customer Name 1",
        "billingPeriodStartDate": "2019-04-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-04-30T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Customer Name 1",
        "accountName": "AccountName",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "SubscriptionName 1",
        "date": "2019-04-09T00:00:00.0000000Z",
        "product": "Product1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 3.6E-05,
        "effectivePrice": 0.054693055510767,
        "cost": 1.968949998E-06,
        "unitPrice": 5.47,
        "billingCurrency": "CAD",
        "resourceLocation": "uswest",
        "consumedService": "Microsoft.ClassicStorage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource-Group-westus/providers/Microsoft.ClassicStorage/storageAccounts/ResourceName1",
        "resourceName": "ResourceName1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "BAS",
        "resourceGroup": "Resource-Group-westus",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

UsageDetailsListFilterByTag-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?$filter=tags eq 'dev:tools'&api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.8234,
        "effectivePrice": 0.010534556373432,
        "cost": 0.000342194841184,
        "unitPrice": 3.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

UsageDetailsListForBillingPeriod-Legacy

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/usageDetails?api-version=2019-10-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201903/providers/Microsoft.Consumption/usageDetails/usageDetails_Id1",
      "name": "usageDetails_Id1",
      "type": "Microsoft.Consumption/usageDetails",
      "kind": "legacy",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingAccountId": "xxxxxxxx",
        "billingAccountName": "Account Name 1",
        "billingPeriodStartDate": "2019-03-01T00:00:00.0000000Z",
        "billingPeriodEndDate": "2019-03-31T00:00:00.0000000Z",
        "billingProfileId": "xxxxxxxx",
        "billingProfileName": "Account Name 1",
        "accountName": "Account Name 1",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "Subscription Name 1",
        "date": "2019-03-30T00:00:00.0000000Z",
        "product": "Product Name 1",
        "partNumber": "Part Number 1",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "meterDetails": null,
        "quantity": 0.8234,
        "effectivePrice": 0.010534556373432,
        "cost": 0.000342194841184,
        "unitPrice": 3.74,
        "billingCurrency": "CAD",
        "resourceLocation": "USEast",
        "consumedService": "Microsoft.Storage",
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Resource Group 1/providers/Microsoft.Storage/storageAccounts/Resource Name 1",
        "resourceName": "Resource Name 1",
        "invoiceSection": "Invoice Section 1",
        "costCenter": "DEV",
        "resourceGroup": "Resource Group 1",
        "offerId": "Offer Id 1",
        "isAzureCreditEligible": false,
        "chargeType": "Usage"
      }
    }
  ]
}

定義

ErrorDetails

錯誤的詳細資料。

ErrorResponse

錯誤回應表示服務無法處理傳入的要求。 錯誤訊息中提供了原因。

某些錯誤回應:

  • 429 TooManyRequests-要求已節流處理。 請在等候 "x-ratelimit-microsoft.--retry" 標頭中指定的時間後重試。

  • 503 ServiceUnavailable-服務暫時無法使用。 請在等候 "Retry" 標頭中指定的時間之後重試。

LegacyUsageDetail

舊版使用狀況詳細資料。

MeterDetailsResponse

計量詳細資料的屬性。

metrictype

允許選取不同類型的成本/使用量記錄。

ModernUsageDetail

新式使用量詳細資料。

UsageDetailsListResult

列出使用量詳細資料的結果。 它包含依計費期間的反向時間順序的可用使用量詳細資料清單。

ErrorDetails

錯誤的詳細資料。

Name Type Description
code
  • string

錯誤碼。

message
  • string

指出作業失敗原因的錯誤訊息。

ErrorResponse

錯誤回應表示服務無法處理傳入的要求。 錯誤訊息中提供了原因。

某些錯誤回應:

  • 429 TooManyRequests-要求已節流處理。 請在等候 "x-ratelimit-microsoft.--retry" 標頭中指定的時間後重試。

  • 503 ServiceUnavailable-服務暫時無法使用。 請在等候 "Retry" 標頭中指定的時間之後重試。

Name Type Description
error

錯誤的詳細資料。

LegacyUsageDetail

舊版使用狀況詳細資料。

Name Type Description
etag
  • string

資源 etag。

id
  • string

資源識別碼。

kind string:
  • legacy

指定使用方式詳細資料的種類。

name
  • string

資源名稱。

properties.accountName
  • string

帳戶名稱。

properties.accountOwnerId
  • string

帳戶擁有者識別碼。

properties.additionalInfo
  • string

此使用方式專案的其他詳細資料。 根據預設,除非在 $expand 中指定,否則不會填入。 使用此欄位來取得使用明細專案特定的詳細資料,例如實際的 VM 大小 (ServiceType) 或套用保留折扣的比率。

properties.billingAccountId
  • string

計費帳戶識別碼。

properties.billingAccountName
  • string

帳單帳戶名稱。

properties.billingCurrency
  • string

帳單貨幣。

properties.billingPeriodEndDate
  • string

計費循環結束日期。

properties.billingPeriodStartDate
  • string

計費循環開始日期。

properties.billingProfileId
  • string

帳單設定檔識別碼。

properties.billingProfileName
  • string

帳單設定檔名稱。

properties.chargeType
  • string

表示費用代表點數、使用量、Marketplace 購買、保留費用或退款。

properties.consumedService
  • string

使用的服務名稱。 發出使用量或購買之 azure 資源提供者的名稱。 未提供 marketplace 使用量的此值。

properties.cost
  • number

稅金前的成本量。

properties.costCenter
  • string

本部門的成本中心(如果它是部門),並提供成本中心。

properties.date
  • string

使用量記錄的日期。

properties.effectivePrice
  • number

依使用量計費的有效價格。

properties.frequency
  • string

指出此費用將會發生的頻率。 OneTime 僅發生一次的購買,每月每月重複一次,並根據使用服務的程度 UsageBased 費用。

properties.invoiceSection
  • string

發票區段名稱。

properties.isAzureCreditEligible
  • boolean

符合 Azure 點數資格。

properties.meterDetails

計量的詳細資料。 根據預設,除非在 $expand 中指定,否則不會填入。

properties.meterId
  • string

(GUID) 的計量識別碼。 不適用於 marketplace。 針對保留實例,這表示已購買保留的主要計量。 針對購買保留的實際 VM 大小,請參閱 productOrderName。

properties.offerId
  • string

供應專案識別碼。例如: MS-MS-AZR-0003P->ms-azr-0017p、MS-MS-AZR-0003P-Ms-azr-0148p。

properties.partNumber
  • string

使用的服務的元件編號。 可以用來與價位表聯結。 不適用於 marketplace。

properties.planName
  • string

方案名稱。

properties.product
  • string

使用的服務或購買的產品名稱。 不適用於 Marketplace。

properties.productOrderId
  • string

產品訂單識別碼。針對保留,這是保留訂單識別碼。

properties.productOrderName
  • string

產品訂單名稱。 針對保留專案,這是購買的 SKU。

properties.publisherName
  • string

發行者名稱。

properties.publisherType
  • string

發行者類型。

properties.quantity
  • number

使用數量。

properties.reservationId
  • string

保留的 ARM 資源識別碼。 只適用于與保留相關的記錄。

properties.reservationName
  • string

使用者提供之保留的顯示名稱。 特定日期的上次已知名稱會填入每日資料。 只適用于與保留相關的記錄。

properties.resourceGroup
  • string

資源組名。

properties.resourceId
  • string

Azure resource manager 資源識別碼。

properties.resourceLocation
  • string

資源位置。

properties.resourceName
  • string

資源名稱。

properties.serviceInfo1
  • string

服務資訊1。

properties.serviceInfo2
  • string

服務資訊2。

properties.subscriptionId
  • string

訂用帳戶 guid。

properties.subscriptionName
  • string

訂用帳戶名稱。

properties.term
  • string

) 月份的詞彙 (。 每月週期性購買1個月。 1年期保留12個月。 3年的保留期為36個月。

properties.unitPrice
  • number

Unit Price 是適用于您的價格。 (您的 EA 或其他合約價格) 。

tags
  • object

資源標籤。

type
  • string

資源類型。

MeterDetailsResponse

計量詳細資料的屬性。

Name Type Description
meterCategory
  • string

計量的類別,例如「雲端服務」、「網路」等等。

meterName
  • string

指定計量類別中的計量名稱。

meterSubCategory
  • string

計量的子類別,例如「A6 雲端服務」、「ExpressRoute (IXP) 」等等。

serviceFamily
  • string

服務系列。

unitOfMeasure
  • string

計量耗用量的收費單位,例如 ' Hours '、' GB ' 等等。

metrictype

允許選取不同類型的成本/使用量記錄。

Name Type Description
actualcost
  • string

實際成本資料。

amortizedcost
  • string

分攤成本資料。

usage
  • string

使用狀況資料。

ModernUsageDetail

新式使用量詳細資料。

Name Type Description
etag
  • string

資源 etag。

id
  • string

資源識別碼。

kind string:
  • modern

指定使用方式詳細資料的種類。

name
  • string

資源名稱。

properties.additionalInfo
  • string

此使用方式專案的其他詳細資料。 使用此欄位來取得使用明細專案特定的詳細資料,例如實際的 VM 大小 (ServiceType) 或套用保留折扣的比率。

properties.billingAccountId
  • string

計費帳戶識別碼。

properties.billingAccountName
  • string

帳單帳戶的名稱。

properties.billingCurrencyCode
  • string

定義計費成本的貨幣。

properties.billingPeriodEndDate
  • string

發票中的計費循環結束日期。

properties.billingPeriodStartDate
  • string

發票中的計費循環開始日期。

properties.billingProfileId
  • string

帳單設定檔的識別碼,該設定檔會針對已上線 Microsoft 客戶合約的客戶,以及已進行權利購買的客戶(例如 SaaS、Marketplace、RI 等),以單數計費貨幣將各發票的成本分組。

properties.billingProfileName
  • string

帳單設定檔的名稱,此設定檔會針對已上線 Microsoft 客戶合約的客戶,以及已進行權利購買的客戶(例如 SaaS、Marketplace、RI 等),以單數計費貨幣將各發票的成本分組。

properties.chargeType
  • string

表示費用代表點數、使用量、Marketplace 購買、保留費用或退款。

properties.consumedService
  • string

使用的服務名稱。 發出使用量或購買之 azure 資源提供者的名稱。 未提供 marketplace 使用量的此值。

properties.costCenter
  • string

本部門的成本中心(如果它是部門),並提供成本中心。

properties.costInBillingCurrency
  • number

以計費貨幣計費之前的 ExtendedCost 或混合成本。

properties.costInPricingCurrency
  • number

要與價格相互關聯的稅前延伸成本或混合成本 (以帳單貨幣為單位)。

properties.costInUSD
  • number

稅金的預估 extendedCost 或混合成本(以美元為單位)。

properties.customerName
  • string

客戶的 AAD 租使用者名稱。

properties.customerTenantId
  • string

客戶的 AAD 租使用者識別碼。

properties.date
  • string

使用量記錄的日期。

properties.exchangeRate
  • string

從定價貨幣轉換成帳單貨幣所使用的匯率。

properties.exchangeRateDate
  • string

從定價貨幣轉換成帳單貨幣的匯率日期。

properties.exchangeRatePricingToBilling
  • number

從定價貨幣到帳單貨幣的匯率。

properties.frequency
  • string

指出此費用將會發生的頻率。 OneTime 僅發生一次的購買,每月每月重複一次,並根據使用服務的程度 UsageBased 費用。

properties.instanceName
  • string

實例名稱。

properties.invoiceId
  • string

發票識別碼,如同特定交易出現的發票。

properties.invoiceSectionId
  • string

在發票中計費之專案的識別碼。 不適用於合作夥伴所登錄的 Microsoft 客戶合約。

properties.invoiceSectionName
  • string

在發票中計費之專案的名稱。 不適用於合作夥伴所登錄的 Microsoft 客戶合約。

properties.isAzureCreditEligible
  • boolean

判斷成本是否有資格使用 Azure 點數來支付費用。

properties.marketPrice
  • number

依使用量計費的市場價格。

properties.meterCategory
  • string

識別使用量的最上層服務。

properties.meterId
  • string

(GUID) 的計量識別碼。 不適用於 marketplace。 針對保留實例,這表示已購買保留的主要計量。 針對購買保留的實際 VM 大小,請參閱 productOrderName。

properties.meterName
  • string

識別測量耗用量所依據的計量名稱。

properties.meterRegion
  • string

針對根據資料中心位置定價的某些服務,識別資料中心的位置。

properties.meterSubCategory
  • string

定義可能會影響費率的 Azure 服務類型或子類別。

properties.partnerEarnedCreditApplied
  • string

指出是否已套用合作夥伴所獲得點數的旗標。

properties.partnerEarnedCreditRate
  • number

可透過合作夥伴管理員連結存取合作夥伴所獲得的點數 (PEC) 時適用的折扣率。

properties.partnerName
  • string

合作夥伴的 AAD 租使用者名稱。

properties.partnerTenantId
  • string

合作夥伴的 AAD 租使用者識別碼。

properties.payGPrice
  • number

資源的零售價格。

properties.paygCostInBillingCurrency
  • number

以計費貨幣計費之前的 PayG 成本量。

properties.paygCostInUSD
  • number

依美國貨幣的稅額之前的 PayG 成本量。

properties.previousInvoiceId
  • string

原始發票有退款 (負成本) 時的參考。 只有在有退款時,才會填入。

properties.pricingCurrencyCode
  • string

定價計費貨幣。

properties.product
  • string

依使用量或購買而產生費用的產品名稱(如發票中所列)。 不適用於 Marketplace。

properties.productIdentifier
  • string

依取用或購買而產生費用之產品的識別碼。 這是合作夥伴中心內 productId 和 SkuId 的串連索引鍵。

properties.productOrderId
  • string

訂用帳戶所屬的資產或 Azure 方案名稱的識別碼。 例如: Azure 方案。 針對保留,這是保留訂單識別碼。

properties.productOrderName
  • string

產品訂單名稱。 針對保留專案,這是購買的 SKU。

properties.publisherId
  • string

發行者識別碼。

properties.publisherName
  • string

服務發行者的名稱,包括 Microsoft 或協力廠商發行者。

properties.publisherType
  • string

識別發行者是否為第一方、協力廠商轉銷商或協力廠商機構的發行者類型。

properties.quantity
  • number

測量購買或取用的數量。計費期間所使用的計量量。

properties.resellerMpnId
  • string

與訂用帳戶相關聯的轉銷商 MPNId。

properties.resellerName
  • string

轉售商名稱。

properties.reservationId
  • string

保留的 ARM 資源識別碼。 只適用于與保留相關的記錄。

properties.reservationName
  • string

使用者提供之保留的顯示名稱。 特定日期的上次已知名稱會填入每日資料。 只適用于與保留相關的記錄。

properties.resourceGroup
  • string

用於一致生命週期管理資源的 Azure 資源組名。

properties.resourceLocation
  • string

資源位置的名稱。

properties.resourceLocationNormalized
  • string

資源位置正規化。

properties.serviceFamily
  • string

列出購買或收費 (範例的服務系列:儲存體;計算) 。

properties.serviceInfo1
  • string

服務資訊1。

properties.serviceInfo2
  • string

服務資訊2。

properties.servicePeriodEndDate
  • string

評等服務使用方式的費用時的期間結束日期。 Azure 服務的價格會依據評等期間來決定。

properties.servicePeriodStartDate
  • string

評等服務使用方式的費用時的評等期間開始日期。 Azure 服務的價格會依據評等期間來決定。

properties.subscriptionGuid
  • string

Microsoft 為 Azure 訂用帳戶產生的唯一識別碼。

properties.subscriptionName
  • string

Azure 訂用帳戶的名稱。

properties.term
  • string

) 月份的詞彙 (。 顯示供應項目有效性的詞彙。 例如, 在保留實例的情況下,會針對保留實例的年度期限顯示12個月。 若購買一次或週期性購買,則條款會顯示1個月;這不適用於 Azure 使用量。

properties.unitOfMeasure
  • string

識別服務的計費單位。 例如,GB、小時、10,000 秒。

properties.unitPrice
  • number

Unit Price 是適用于您的價格。 (您的 EA 或其他合約價格) 。

tags
  • object

資源標籤。

type
  • string

資源類型。

UsageDetailsListResult

列出使用量詳細資料的結果。 它包含依計費期間的反向時間順序的可用使用量詳細資料清單。

Name Type Description
nextLink
  • string

連結 (url) 至下一個結果頁面。

value UsageDetail[]:

使用方式詳細資料的清單。