다음을 통해 공유


Azure Consumption

Azure Consumption API는 Azure 리소스의 비용 및 사용량 현황 데이터에 프로그래밍 방식으로 액세스하는 방법을 제공합니다. API는 현재 엔터프라이즈 등록, 웹 직접 구독(몇 가지 예외 포함) 및 CSP Azure 플랜 구독만 지원합니다. API는 다른 형식의 Azure 구독을 지원하도록 지속적으로 업데이트됩니다.

Azure Consumption API는 다음에 대한 액세스를 제공합니다.

  • 기업 고객만
    • 가격표
    • 예산
    • 예측
    • 잔액
    • 태그
    • 비용 태그
  • 기업 및 웹 직접 고객
    • 예약 세부 정보
    • 예약 요약
    • Marketplace 요금
    • 사용량 세부 정보
    • 예약 권장 사항

지원되지 않는 구독 형식 목록

  • MS-AZR-0145P(CSP)
  • MS-AZR-0146P(CSP)
  • MS-AZR-159P(CSP)
  • MS-AZR-0036P(스폰서)
  • MS-AZR-0143P(스폰서)
  • MS-AZR-0015P(내부)
  • MS-AZR-0144P(DreamSpark)

청구 기간 및 날짜 범위 작업

사용량 세부 정보Marketplace 요금은 사용량 데이터의 시작 및 종료 날짜를 정의하기 위한 청구 기간 또는 날짜 범위를 허용합니다.

다음은 요청의 청구 기간 및 날짜 범위를 기반으로 하는 API 동작입니다.

요청에 있는 청구 기간 요청에 있는 시작 날짜 요청에 있는 종료 날짜 API 동작
아니요 아니요 아니요 현재 청구 기간에 대한 데이터가 응답으로 반환됩니다.
아니요 아니요 현재 청구 기간에 대한 데이터가 응답으로 반환됩니다.
아니요 아니요 현재 청구 기간에 대한 데이터가 응답으로 반환됩니다.
아니요 지정된 시작 및 종료 날짜에 대한 데이터가 응답으로 반환됩니다.
아니요 아니요 지정된 청구 기간에 대한 데이터가 응답으로 반환됩니다.
아니요 지정된 청구 기간에 대한 데이터가 응답으로 반환됩니다.
아니요 지정된 청구 기간에 대한 데이터가 응답으로 반환됩니다.
지정된 시작 및 종료 날짜에 대한 데이터가 응답으로 반환되고 제공된 청구 기간은 무시됩니다.

허용되는 최대 날짜 범위는 한 요청에서 12개월이며 데이터는 2014년 5월 1일 이상에서 사용할 수 있습니다.

청구 기간 목록 가져오기

요청에서 유효한 청구 기간을 제공하기 위해 클라이언트는 먼저 다음 API를 사용하여 구독별로 사용 가능한 청구 기간 목록을 가져와야 합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview

이 목록을 사용하여 클라이언트는 특정 청구 기간을 선택하여 소비 데이터를 가져올 수 있습니다.

늦게 도착하는 데이터

보고 사용량이 지연되는 타사 서비스를 수용하기 위해 보고된 사용량 날짜는 실제 사용량이 발생한 시간과 달리 사용 현황 데이터가 전송된 시간으로 설정됩니다.

따라서 사용량에 대한 등급이 지정되고 보고된 시간에 적용됩니다. 실제 소비 시간을 나타내기 위해 속성입니다. AdditionalProperties 필드에는 이제 두 개의 추가 속성이 포함됩니다. ConsumptionBeginTimeConsumptionEndTime 은 실제 사용 시간 기간에 해당하는 새 필드입니다.

이러한 변경으로 인해 사용량 세부 정보 API를 호출할 때 해결해야 하는 몇 가지 시나리오가 발생합니다.

  1. 월 종료 보고: 한 달 동안 발생했지만 다음 달에 보고된 사용량의 경우 고객은 additionalProperties 필드를 확인하여 적절한 달에 사용량을 할당해야 합니다.

  2. 쿼리 사용량 세부 정보: 날짜 범위별로 사용량 세부 정보 API를 쿼리할 때 쿼리는 additionalProperties 필드의 사용 시간이 아닌 사용량 보고서 날짜에만 적용됩니다. 사용량 세부 정보를 청구서에 매핑하려는 고객의 경우 청구서가 사용 현황 보고서 날짜를 기준으로 사용량을 처리하므로 이 업데이트는 프로세스에 영향을 주지 않습니다. 고객의 경우 사용량 세부 정보를 특정 달력 날짜/월에 매핑하려는 경우 이 업데이트는 호환성이 손상되는 변경이며 이러한 시나리오에서는 사용 현황 보고서 날짜를 사용할 수 없으며 사용량이 발생한 날짜는 additionalProperties 섹션에서 사용해야 합니다.

추가 세부 정보에 대한 샘플 호출:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

샘플 응답 코드 조각:

  "properties": {
    "billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
    "usageStart":"2018-05-01T00:00:00.0000000Z",
    "usageEnd":"2018-05-01T23:59:59.0000000Z",
    "instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
    "instanceName":"{id}",
    "instanceLocation":"SouthCentralUS",
    "meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
    "usageQuantity":0.002065,
    "pretaxCost":0,
    "currency":"USD",
    "additionalProperties": {
      "Provider": "1",
      "ConsumptionBeginTime": "2018-05-01T19:00:00",
      "ConsumptionEndTime": "2018-05-01T20:00:00"
    }
  }

추가 정보

언어별 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

Azure Consumption Python SDK

Azure Consumption CLI

Azure Consumption NodeJS SDK

Azure Consumption Ruby SDK