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 동작입니다.
| 요청에 있는 청구 기간 | 요청에 있는 시작 날짜 | 요청에 있는 종료 날짜 | API 동작 |
|---|---|---|---|
| 아니요 | 아니요 | 아니요 | 현재 청구 기간에 대한 데이터가 응답으로 반환됩니다. |
| 아니요 | 예 | 아니요 | 현재 청구 기간에 대한 데이터가 응답으로 반환됩니다. |
| 아니요 | 아니요 | 예 | 현재 청구 기간에 대한 데이터가 응답으로 반환됩니다. |
| 아니요 | 예 | 예 | 지정된 시작 및 종료 날짜에 대한 데이터가 응답으로 반환됩니다. |
| 예 | 아니요 | 아니요 | 지정된 청구 기간에 대한 데이터가 응답으로 반환됩니다. |
| 예 | 예 | 아니요 | 지정된 청구 기간에 대한 데이터가 응답으로 반환됩니다. |
| 예 | 아니요 | 예 | 지정된 청구 기간에 대한 데이터가 응답으로 반환됩니다. |
| 예 | 예 | 예 | 지정된 시작 및 종료 날짜에 대한 데이터가 응답으로 반환되고 제공된 청구 기간은 무시됩니다. |
허용되는 최대 날짜 범위는 한 번의 요청에서 12개월이며 데이터는 2014년 5월 1일 이후에 사용할 수 있습니다.
청구 기간 목록 가져오기
요청에서 유효한 청구 기간을 제공하기 위해 클라이언트는 먼저 다음 API를 사용하여 구독별로 사용 가능한 청구 기간 목록을 가져와야 합니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview
이 목록을 사용하여 클라이언트는 특정 청구 기간을 선택하여 소비 데이터를 가져올 수 있습니다.
늦게 도착하는 데이터
사용량 보고가 지연되는 타사 서비스를 수용하기 위해 보고된 사용량 날짜는 실제 사용량이 발생한 시간, 즉 소비 시간이 아닌 사용량 데이터가 전송된 시간으로 설정됩니다.
결과적으로 사용량은 보고된 시간에 대해 평가되고 적용됩니다. 실제 소비 시간을 나타내기 위해 속성. 이제 AdditionalProperties 필드에는 두 개의 추가 속성이 포함됩니다. ConsumptionBeginTime 및 ConsumptionEndTime 은 실제 소비 시간 창에 해당하는 새 필드입니다.
이러한 변경으로 인해 사용량 세부 정보 API를 호출할 때 해결해야 하는 몇 가지 시나리오가 발생합니다.
월말 보고: 한 달 동안 발생했지만 다음 달에 보고된 사용량의 경우 고객은 additionalProperties 필드를 확인하여 해당 월에 사용량을 할당해야 합니다.
사용량 세부 정보 쿼리: 날짜 범위별로 사용량 세부 정보 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요