Azure 사용량

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

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

• 기업 고객 전용
  • 가격표
  • 예산
  • 예측
  • Balances
  • 태그들
  • 비용 태그
• 엔터프라이즈 및 웹 다이렉트 고객
  • 예약 세부 정보
  • 예약 요약
  • 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)

청구 기간 및 날짜 범위 작업

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

요청의 청구 기간과 날짜 범위에 따른 API 동작은 다음과 같습니다:

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

청구 기간 목록 가져오기

요청에서 유효한 청구 기간을 제공하려면, 클라이언트는 먼저 다음 API를 사용하여 구독을 통해 이용 가능한 청구 기간 목록을 받아야 합니다

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

이 목록을 통해 고객은 특정 청구 기간을 선택하여 소비 데이터를 얻을 수 있습니다.

늦게 도착하는 데이터

사용량 보고 지연이 있는 제3자 서비스를 고려하여, 보고 사용 날짜는 실제 사용량이 발생한 시점(소비 시간)이 아닌 데이터 전송 시점으로 설정됩니다.

따라서 사용량은 보고 시간에 대해 평가되고 적용됩니다. 실제 소비 시간을 나타내기 위해 부동산을 나타냅니다. AdditionalProperties 필드에는 이제 두 개의 다른 속성이 포함됩니다. ConsumptionBeginTime 및 ConsumptionEndTime 은 실제 소비 시간 창에 해당하는 새 필드입니다.

이러한 변경은 사용 상세 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 소비 Python SDK

Azure 소비 CLI

Azure 소비 NodeJS SDK

Azure 소비 Ruby SDK