Usage Details - List

Service:

Consumption

API Version:

2023-05-01

정의된 scope 대한 사용량 세부 정보를 Lists. 사용량 세부 정보는 이 API를 통해 2014년 5월 1일 이상에만 사용할 수 있습니다.

참고:Microsoft는 향후 특정 시점에 사용량 세부 정보 API를 사용 중지할 예정입니다. 이 API에 대한 새로운 종속성을 사용하지 않는 것이 좋습니다. 대신 비용 세부 정보 API를 사용하세요. 사용 중지 날짜가 결정되면 고객에게 알립니다. 자세한 내용은 비용 세부 정보 보고서 생성 - 작업 만들기를 참조하세요.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2023-05-01

With optional parameters:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
scope	path	True	string	사용량 세부 정보 작업과 연결된 scope. 여기에는 구독 scope 대한 '/subscriptions/{subscriptionId}/', 청구 계정 scope 대한 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}', 부서 scope '/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccounts/{enrollmentAccountId}'가 포함됩니다scope 및 관리 그룹 scope 대한 '/providers/Microsoft.Management/managementGroups/{managementGroupId}' 구독, 청구 계정, 부서, 등록 계정 및 관리 그룹의 경우 '/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}'을 사용하여 scope 청구 기간을 추가할 수도 있습니다. 예를 들어 부서에서 청구 기간을 지정하려면 scope '/providers/Microsoft.Billing/departments/{departmentId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}'을 사용합니다. 또한 최신 상거래 계정 범위는 billingAccount scope 대한 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}'입니다. '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' invoiceSection scope 및 파트너에 한정된 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/customers/{customerId}'
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2023-03-01입니다.
$expand	query		string	사용량 세부 정보 목록 내에서 properties/additionalInfo 또는 properties/meterDetails를 확장하는 데 사용할 수 있습니다. 기본적으로 이러한 필드는 사용량 세부 정보를 나열할 때 포함되지 않습니다.
$filter	query		string	properties/resourceGroup, properties/resourceName, properties/resourceId, properties/chargeType, properties/reservationId, properties/publisherType 또는 태그별로 usageDetails를 필터링하는 데 사용할 수 있습니다. 필터는 'eq', 'lt', 'gt', 'le', 'ge', 'and'를 지원합니다. 현재 'ne', 'or' 또는 'not'을 지원하지 않습니다. 태그 필터는 키와 값이 콜론(:) 구분되는 키 값 쌍 문자열입니다. PublisherType 필터는 azure와 marketplace의 두 값을 허용하며 현재 웹 직접 제품 유형에 대해 지원됩니다.
$skiptoken	query		string	Skiptoken은 이전 작업에서 부분 결과를 반환한 경우에만 사용됩니다. 이전 응답에 nextLink 요소가 포함된 경우 nextLink 요소의 값에는 후속 호출에 사용할 시작점을 지정하는 skiptoken 매개 변수가 포함됩니다.
$top	query		integer int32	결과 수를 최신 N usageDetails로 제한하는 데 사용할 수 있습니다.
metric	query		metrictype	다양한 유형의 비용/사용량 레코드를 선택할 수 있습니다.

응답

Name	형식	Description
200 OK	UsageDetailsListResult	OK. 요청이 성공했습니다.
204 No Content		콘텐츠가 없습니다. 요청이 성공했지만 결과를 반환하지 않았습니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

BillingAccountUsageDetailsList-Modern

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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-09-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-09-30T00: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": "Microsoft",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-09-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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

BillingAccountUsageDetailsListForBillingPeriod-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

BillingProfileUsageDetailsList-Modern

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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-09-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-09-30T00: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": "Microsoft",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-09-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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

CustomerUsageDetailsList-Modern

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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-09-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-09-30T00: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": "Microsoft",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-09-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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

DepartmentUsageDetailsList-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

DepartmentUsageDetailsListForBillingPeriod-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

EnrollmentAccountUsageDetailsList-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

EnrollmentAccountUsageDetailsListForBillingPeriod-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

InvoiceSectionUsageDetailsList-Modern

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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-09-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-09-30T00: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": "Microsoft",
        "resourceLocationNormalized": "US East",
        "serviceInfo1": "",
        "serviceInfo2": "Windows Client BYOL",
        "servicePeriodEndDate": "2019-12-01T00:00:00Z",
        "servicePeriodStartDate": "2019-09-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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

ManagementGroupUsageDetailsList-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    },
    {
      "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

ManagementGroupUsageDetailsListForBillingPeriod-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    },
    {
      "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

UsageDetailsExpand-Legacy

Sample Request

HTTP

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=2023-05-01

Sample Response

Status code:

200

{
  "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\"}",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

UsageDetailsList-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

UsageDetailsListByMetricActualCost-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

UsageDetailsListByMetricAmortizedCost-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

UsageDetailsListByMetricUsage-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

UsageDetailsListFilterByTag-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

UsageDetailsListForBillingPeriod-Legacy

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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",
        "benefitId": "00000000-0000-0000-0000-000000000000",
        "benefitName": "Reservation_purchase_03-09-2018_10-59"
      }
    }
  ]
}

Status code:

204

정의

Name	Description
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간 동안 기다린 후 다시 시도합니다.
LegacyUsageDetail	레거시 사용량 세부 정보입니다.
MeterDetailsResponse	미터 세부 정보의 속성입니다.
metrictype	다양한 유형의 비용/사용량 레코드를 선택할 수 있습니다.
ModernUsageDetail	최신 사용량 세부 정보입니다.
pricingModelType	미터 요금을 책정하는 방식을 나타내는 식별자입니다.
UsageDetailsListResult	사용량 세부 정보를 나열한 결과입니다. 여기에는 청구 기간별 역순으로 사용 가능한 사용량 세부 정보 목록이 포함되어 있습니다.

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

• 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

• 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간 동안 기다린 후 다시 시도합니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

LegacyUsageDetail

레거시 사용량 세부 정보입니다.

Name	형식	Description
etag	string	리소스의 etag입니다.
id	string	이벤트의 정규화된 ARM ID입니다.
kind	string: legacy	사용량 세부 정보의 종류를 지정합니다.
name	string	이벤트를 고유하게 식별하는 ID입니다.
properties.accountName	string	계정 이름입니다.
properties.accountOwnerId	string	계정 소유자 ID입니다.
properties.additionalInfo	string	이 사용 항목에 대한 추가 세부 정보입니다. $expand 지정하지 않으면 기본적으로 채워지지 않습니다. 이 필드를 사용하여 실제 VM 크기(ServiceType) 또는 예약 할인이 적용되는 비율과 같은 사용량 품목별 세부 정보를 가져옵니다.
properties.benefitId	string	해당 혜택에 대한 고유 식별자입니다.
properties.benefitName	string	적용 가능한 혜택의 이름입니다.
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 리소스 공급자의 이름입니다. 이 값은 마켓플레이스 사용에 대해 제공되지 않습니다.
properties.cost	number	세금 전 비용의 양입니다.
properties.costCenter	string	부서이고 비용 센터가 제공되는 경우 이 부서의 비용 센터입니다.
properties.date	string	사용량 레코드의 날짜입니다.
properties.effectivePrice	number	사용량에 대해 청구되는 유효 가격입니다.
properties.frequency	string	이 요금이 발생하는 빈도를 나타냅니다. 한 번만 발생하는 구매의 경우 OneTime, 매월 발생하는 요금의 경우 월별 및 사용량 기준 서비스 사용량에 따른 요금 기준입니다.
properties.invoiceSection	string	청구서 섹션 이름입니다.
properties.isAzureCreditEligible	boolean	Azure 크레딧 적격입니다.
properties.meterDetails	MeterDetailsResponse	미터에 대한 세부 정보입니다. $expand 지정하지 않으면 기본적으로 채워지지 않습니다.
properties.meterId	string	미터 ID(GUID)입니다. 마켓플레이스에서 사용할 수 없습니다. 예약된 instance 예약이 구매된 기본 미터를 나타냅니다. 예약을 구매한 실제 VM 크기는 productOrderName을 참조하세요.
properties.offerId	string	제품 ID. 예: MS-AZR-0017P, MS-AZR-0148P.
properties.partNumber	string	파트 사용된 서비스의 번호입니다. 가격표와 조인하는 데 사용할 수 있습니다. 마켓플레이스에서 사용할 수 없습니다.
properties.payGPrice	number	리소스의 소매 가격입니다.
properties.planName	string	계획 이름입니다.
properties.pricingModel	pricingModelType	미터 요금을 책정하는 방식을 나타내는 식별자입니다.
properties.product	string	사용된 서비스 또는 구매의 제품 이름입니다. Marketplace에는 사용할 수 없습니다.
properties.productOrderId	string	제품 주문 ID입니다. 예약의 경우 예약 주문 ID입니다.
properties.productOrderName	string	제품 주문 이름입니다. 예약의 경우 구매한 SKU입니다.
properties.publisherName	string	게시자 이름입니다.
properties.publisherType	string	게시자 유형입니다.
properties.quantity	number	사용량 수량입니다.
properties.reservationId	string	예약의 ARM 리소스 ID입니다. 예약과 관련된 레코드에만 적용됩니다.
properties.reservationName	string	사용자가 제공한 예약의 표시 이름입니다. 특정 날짜의 마지막으로 알려진 이름은 일별 데이터에 채워집니다. 예약과 관련된 레코드에만 적용됩니다.
properties.resourceGroup	string	리소스 그룹 이름입니다.
properties.resourceId	string	Azure Resource Manager 사용량 세부 정보 리소스의 고유 식별자입니다.
properties.resourceLocation	string	리소스 위치입니다.
properties.resourceName	string	리소스 이름입니다.
properties.serviceInfo1	string	서비스 특정 메타데이터입니다.
properties.serviceInfo2	string	선택적 서비스 특정 메타데이터를 포함하는 레거시 필드입니다.
properties.subscriptionId	string	구독 GUID입니다.
properties.subscriptionName	string	구독 이름입니다.
properties.term	string	기간(월). 월별 되풀이 구매의 경우 1개월입니다. 1년 예약의 경우 12개월입니다. 3년 예약의 경우 36개월입니다.
properties.unitPrice	number	단가는 사용자에게 적용되는 가격입니다. (EA 또는 기타 계약 가격).
tags	object	리소스 태그.
type	string	리소스 종류.

MeterDetailsResponse

미터 세부 정보의 속성입니다.

Name	형식	Description
meterCategory	string	미터의 범주(예: '클라우드 서비스', '네트워킹' 등)입니다.
meterName	string	지정된 미터 범주 내의 미터 이름입니다.
meterSubCategory	string	미터의 하위 범주(예: 'A6 클라우드 서비스', 'ExpressRoute(IXP)' 등)입니다.
serviceFamily	string	서비스 패밀리입니다.
unitOfMeasure	string	미터 사용량이 청구되는 단위(예: '시간', 'GB' 등)입니다.

metrictype

다양한 유형의 비용/사용량 레코드를 선택할 수 있습니다.

Name	형식	Description
actualcost	string	실제 비용 데이터입니다.
amortizedcost	string	분할 상환 비용 데이터.
usage	string	사용량 현황 데이터.

ModernUsageDetail

최신 사용량 세부 정보입니다.

Name	형식	Description
etag	string	리소스의 etag입니다.
id	string	이벤트의 정규화된 ARM ID입니다.
kind	string: modern	사용량 세부 정보의 종류를 지정합니다.
name	string	이벤트를 고유하게 식별하는 ID입니다.
properties.additionalInfo	string	이 사용 항목에 대한 추가 세부 정보입니다. 이 필드를 사용하여 실제 VM 크기(ServiceType) 또는 예약 할인이 적용되는 비율과 같은 사용량 품목별 세부 정보를 가져옵니다.
properties.benefitId	string	해당 혜택에 대한 고유 식별자입니다.
properties.benefitName	string	적용 가능한 혜택의 이름입니다.
properties.billingAccountId	string	청구 계정 식별자입니다.
properties.billingAccountName	string	청구 계정의 이름입니다.
properties.billingCurrencyCode	string	청구되 비용을 정의하는 통화입니다.
properties.billingPeriodEndDate	string	청구서와 같은 청구 기간 종료 날짜입니다.
properties.billingPeriodStartDate	string	청구서와 같이 청구 기간 시작 날짜입니다.
properties.billingProfileId	string	Microsoft 고객 계약을 온보딩한 고객 및 SaaS, Marketplace, RI 등과 같은 자격 구매를 한 CSP의 고객에 걸쳐 단일 청구 통화로 청구서 간에 비용을 그룹화한 청구 프로필의 식별자입니다.
properties.billingProfileName	string	Microsoft 고객 계약을 온보딩한 고객 및 SaaS, Marketplace, RI 등과 같은 자격 구매를 한 CSP의 고객 전체에서 단일 청구 통화로 청구서 간에 비용을 그룹화한 청구 프로필의 이름입니다.
properties.chargeType	string	요금은 크레딧, 사용량, Marketplace 구매, 예약 수수료 또는 환불을 나타냅니다.
properties.consumedService	string	사용된 서비스 이름입니다. 사용량을 내보내거나 구매한 Azure 리소스 공급자의 이름입니다. 이 값은 마켓플레이스 사용에 대해 제공되지 않습니다.
properties.costAllocationRuleName	string	비용 할당 규칙의 이름입니다.
properties.costCenter	string	부서이고 비용 센터가 제공되는 경우 이 부서의 비용 센터입니다.
properties.costInBillingCurrency	number	ExtendedCost 또는 혼합 비용 전에 청구된 통화로 세금이 부과됩니다.
properties.costInPricingCurrency	number	가격과의 상관 관계를 위한 가격 책정 통화 단위의 세전 혼합 비용 또는 ExtendedCost입니다.
properties.costInUSD	number	예상 extendedCost 또는 세금 전 혼합 비용(USD)입니다.
properties.customerName	string	고객의 AAD 테넌트 이름입니다.
properties.customerTenantId	string	고객의 AAD 테넌트 식별자입니다.
properties.date	string	사용량 레코드의 날짜입니다.
properties.effectivePrice	number	사용량에 대해 청구되는 유효 가격입니다.
properties.exchangeRate	string	가격 책정 통화에서 청구 통화로 변환하는 데 사용되는 환율입니다.
properties.exchangeRateDate	string	가격 책정 통화에서 청구 통화로 변환하는 데 사용된 환율 날짜입니다.
properties.exchangeRatePricingToBilling	number	가격 책정 통화에서 청구 통화로의 환율입니다.
properties.frequency	string	이 요금이 발생하는 빈도를 나타냅니다. 한 번만 발생하는 구매의 경우 OneTime, 매월 발생하는 요금에 대한 월별 및 서비스 사용량에 따른 요금에 대한 UsageBased입니다.
properties.instanceName	string	인스턴스 이름
properties.invoiceId	string	특정 트랜잭션이 표시되는 청구서의 청구서 ID입니다.
properties.invoiceSectionId	string	청구서에 청구되는 프로젝트의 식별자입니다. 파트너가 온보딩한 Microsoft 고객 계약에는 적용되지 않습니다.
properties.invoiceSectionName	string	청구서에 청구되는 프로젝트의 이름입니다. 파트너가 온보딩한 Microsoft 고객 계약에는 적용되지 않습니다.
properties.isAzureCreditEligible	boolean	비용이 Azure 크레딧 사용에 대해 지불될 수 있는지 여부를 결정합니다.
properties.marketPrice	number	사용량에 대해 청구되는 시장 가격입니다.
properties.meterCategory	string	사용량에 대한 최상위 서비스를 식별합니다.
properties.meterId	string	미터 ID(GUID)입니다. 마켓플레이스에서 사용할 수 없습니다. 예약된 instance 예약이 구매된 기본 미터를 나타냅니다. 예약을 구매한 실제 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.pricingModel	pricingModelType	측정기 가격 책정 방법을 나타내는 식별자
properties.product	string	청구서에 나열된 대로 소비 또는 구매별로 요금이 발생한 제품의 이름입니다. Marketplace에는 사용할 수 없습니다.
properties.productIdentifier	string	소비 또는 구매로 요금이 발생한 제품의 식별자입니다. 파트너 센터에서 productId 및 SkuId의 연결된 키입니다.
properties.productOrderId	string	구독이 속한 자산 또는 Azure 플랜 이름의 식별자입니다. 예: Azure 플랜. 예약의 경우 예약 주문 ID입니다.
properties.productOrderName	string	제품 주문 이름입니다. 예약의 경우 구매한 SKU입니다.
properties.provider	string	제품 범주 또는 기간 업무 식별자, 예 - Azure, Microsoft 365, AWS e.t.c
properties.publisherId	string	게시자 ID입니다.
properties.publisherName	string	Microsoft 또는 타사 게시자를 포함한 서비스 게시자의 이름입니다.
properties.publisherType	string	게시자가 자사, 타사 재판매인 또는 타사 기관인지 여부를 식별하는 게시자 유형입니다.
properties.quantity	number	구매하거나 소비한 수량을 측정합니다. 청구 기간 동안 사용된 미터의 양입니다.
properties.resellerMpnId	string	구독과 연결된 재판매인의 MPNId입니다.
properties.resellerName	string	재판매인 이름입니다.
properties.reservationId	string	예약의 ARM 리소스 ID입니다. 예약과 관련된 레코드에만 적용됩니다.
properties.reservationName	string	사용자가 예약의 표시 이름을 제공했습니다. 특정 날짜의 마지막으로 알려진 이름은 일별 데이터에 채워집니다. 예약과 관련된 레코드에만 적용됩니다.
properties.resourceGroup	string	리소스의 통합 수명 주기 관리에 사용되는 Azure 리소스 그룹의 이름입니다.
properties.resourceLocation	string	리소스 위치의 이름입니다.
properties.resourceLocationNormalized	string	리소스 위치가 정규화되었습니다.
properties.serviceFamily	string	구매하거나 청구한 제품의 서비스 제품군을 나열합니다(예: 스토리지 ; Compute).
properties.serviceInfo1	string	서비스 특정 메타데이터입니다.
properties.serviceInfo2	string	선택적 서비스 특정 메타데이터를 포함하는 레거시 필드입니다.
properties.servicePeriodEndDate	string	요금을 위해 서비스 사용량이 평가되는 기간의 종료 날짜입니다. Azure 서비스의 가격은 평가 기간을 기반으로 결정됩니다.
properties.servicePeriodStartDate	string	요금을 위해 서비스 사용량이 평가되는 평가 기간의 시작 날짜입니다. Azure 서비스의 가격은 평가 기간에 따라 결정됩니다.
properties.subscriptionGuid	string	Azure 구독에 대한 고유한 Microsoft 생성 식별자입니다.
properties.subscriptionName	string	Azure 구독의 이름입니다.
properties.term	string	용어(월 단위)입니다. 제품의 유효 기간을 표시합니다. 예를 들어 모바일 서비스는 스크립트 실행 간에 상태를 유지하지 않으므로 스크립트 실행 간에 지속되어야 하는 모든 데이터를 테이블에 저장해야 합니다. 예약 인스턴스의 경우 예약된 instance 연간 기간 동안 12개월을 표시합니다. 일회성 구매 또는 반복 구매의 경우 1개월이라는 용어가 표시됩니다. Azure 사용량에는 적용되지 않습니다.
properties.unitOfMeasure	string	서비스 요금이 청구되는 단위를 식별합니다. GB, 시간, 10,000초 등을 예로 들 수 있습니다.
properties.unitPrice	number	단가는 사용자에게 적용되는 가격입니다. (EA 또는 기타 계약 가격).
tags	object	리소스 태그.
type	string	리소스 종류.

pricingModelType

미터 요금을 책정하는 방식을 나타내는 식별자입니다.

Name	형식	Description
On Demand	string
Reservation	string
Spot	string

UsageDetailsListResult

사용량 세부 정보를 나열한 결과입니다. 여기에는 청구 기간별 역순으로 사용 가능한 사용량 세부 정보 목록이 포함되어 있습니다.

Name	형식	Description
nextLink	string	결과의 다음 페이지에 대한 링크(URL)입니다.
value	UsageDetail[]: LegacyUsageDetail[] ModernUsageDetail[]	사용량 세부 정보 목록입니다.