EA 가격표 API에서 마이그레이션
가격표를 가져오기 위해 이전에 Enterprise Reporting consumption.azure.com API를 사용했던 EA 고객은 대체 Azure Resource Manager API로 마이그레이션해야 합니다. 다음 지침은 마이그레이션에 도움이 되며 이전 API와 새 API 간의 계약 차이점도 설명합니다.
참고 항목
모든 Azure Enterprise Reporting API는 사용 중지됩니다. 가능한 한 빨리 Microsoft Cost Management API로 마이그레이션해야 합니다.
API를 호출하려면 서비스 주체에게 권한을 할당합니다.
API를 호출하기 전에 올바른 권한으로 SPN(서비스 주체)을 구성해야 합니다. 서비스 사용자를 이용해 API를 호출합니다. 자세한 내용은 Cost Management API에 권한 할당을 참조하세요.
가격표 API 호출
가격표 API는 가격표를 비동기적으로 생성하고 다운로드한 파일을 생성합니다.
새 가격표 API를 호출할 때 다음 요청 URI를 사용합니다.
지원되는 요청
다음 범위를 사용하여 API를 호출할 수 있습니다.
등록: providers/Microsoft.Billing/billingAccounts/{billingAccountId}
지정된 청구 기간에 대한 청구 계정으로 다운로드
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01
POST 요청은 다음 응답에 설명된 대로 보고서 생성 상태를 폴링할 위치를 반환합니다.
샘플 응답
상태 코드: 202
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Retry-After: 60
상태 코드: 200
{
"status": "Completed",
"properties": {
"downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
"validTill": "2023-09-30T17:32:28Z"
}
}
보고서 생성 상태를 폴링하는 요청 샘플
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
응답 본문 변경
[
{
"id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
"id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
"billingPeriodId": "201404",
"meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
"meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
"unitOfMeasure": "100 GB",
"includedQuantity": 0,
"partNumber": "N9H-00402",
"unitPrice": 0.00,
"currencyCode": "USD"
},
...
]
새 응답 변경 내용
가격표 속성은 다음과 같습니다.
| 이름 | 타입 | 설명 |
|---|---|---|
| basePrice | string | 고객이 로그인한 시점의 단가 또는 서비스 미터 GA 시작 시의 단가(로그온 후인 경우)입니다. 기업계약 사용자에게 적용됩니다. |
| currencyCode | string | 기업계약이 체결된 통화 |
| effectiveEndDate | string | 가격표 청구 기간의 유효 종료 날짜 |
| effectiveStartDate | string | 가격표 청구 기간의 유효 시작 날짜 |
| enrollmentNumber | string | EA 청구 계정에 대한 고유 식별자입니다. |
| includedQuantity | string | EA 고객이 증분 요금 없이 사용할 수 있는 특정 서비스의 수량입니다. |
| marketPrice | string | 특정 제품이나 서비스의 현재 정가입니다. 이 가격은 어떠한 협상도 하지 않으며 Microsoft 계약 유형을 기반으로 합니다. PriceType 사용량의 경우 시장 가격은 종량제 가격으로 반영됩니다. PriceType 저축 플랜의 경우 시장 가격은 해당 약정 기간에 대한 종량제 가격 위에 저축 플랜 혜택을 반영합니다. PriceType ReservedInstance의 경우 시장 가격은 1년 또는 3년 약정의 총 가격을 반영합니다. 참고: 협상이 없는 EA 고객의 경우 시장 가격이 단가와 다른 10진수 정밀도로 반올림된 것처럼 보일 수 있습니다. |
| meterCategory | string | 측정기에 대한 분류 범주의 이름입니다. 예: 클라우드 서비스, 네트워킹 등. |
| meterId | string | 미터의 고유 식별자 |
| meterName | string | 측정기의 이름입니다. 측정기는 Azure 서비스의 배포 가능한 리소스를 나타냅니다. |
| meterRegion | string | 서비스의 미터를 사용할 수 있는 Azure 지역의 이름입니다. |
| meterSubCategory | string | 미터의 하위 분류 범주 이름입니다. |
| meterType | string | 미터 형식의 이름 |
| partNumber | string | 미터와 연결된 부품 번호 |
| priceType | string | 제품의 가격 유형입니다. 예를 들어 priceType을 사용량으로 하는 종량제 요금이 있는 Azure 리소스입니다. 다른 가격 유형에는 ReservedInstance 및 저축 계획이 포함됩니다. |
| product | string | 요금이 발생하는 제품의 이름입니다. |
| productId | string | 측정기가 사용된 제품의 고유 식별자입니다. |
| serviceFamily | 번호 | Azure 서비스의 유형입니다. 예를 들어 Compute, Analytics 및 Security가 있습니다. |
| skuId | string | SKU의 고유 식별자 |
| 용어 | string | Azure 저축 계획 또는 예약 기간의 기간 – 1년 또는 3년(P1Y 또는 P3Y) |
| unitOfMeasure | string | 서비스에 대한 사용량 측정 방법 |
| unitPrice | string | 지정된 제품 또는 서비스에 대한 청구 시점의 단가로, 시장 가격을 기준으로 협상 할인을 포함합니다. PriceType ReservedInstance의 경우 단가는 할인을 포함한 1년 또는 3년 약정의 총 비용을 반영합니다. 참고: 계층 간 가격이 차등화된 서비스의 경우 단가는 사용량 세부 정보 다운로드의 유효 가격과 동일하지 않습니다. 서비스가 다중 계층 가격 책정인 경우 유효 가격은 계층 전체에서 혼합된 요금이며 계층별 단가를 표시하지 않습니다. 혼합 가격 또는 유효 가격은 (각 계층이 특정 단가를 가지는) 여러 계층에 걸친 소비 수량의 순 가격입니다. |
관련 콘텐츠
- EA Reporting에서 ARM API로 마이그레이션 개요 문서를 참조하세요.