EA 예약 인스턴스 사용량 세부 정보 API에서 마이그레이션

예약 인스턴스 사용량 세부 정보를 가져오기 위해 이전에 Enterprise Reporting consumer.azure.com API를 사용했던 EA 고객은 패리티 Azure Resource Manager API로 마이그레이션해야 합니다. 다음 지침은 마이그레이션 API와 새 API 간의 계약 차이점을 마이그레이션하고 토론하는 데 도움이 됩니다.

참고 항목

모든 Azure Enterprise Reporting API는 사용 중지됩니다. 가능한 한 빨리 Microsoft Cost Management API로 마이그레이션해야 합니다.

API를 호출하려면 서비스 주체에게 권한을 할당합니다.

API를 호출하기 전에 올바른 권한으로 서비스 이용자를 구성해야 합니다. 서비스 사용자를 이용해 API를 호출합니다. 자세한 내용은 Cost Management API에 권한 할당을 참조하세요.

예약 인스턴스 사용량 세부 정보 API 호출

Microsoft는 이전 동기 기반 예약 세부 정보 API를 업데이트하지 않습니다. 마이그레이션할 때 최신 SPN 지원 비동기 API 호출 패턴으로 이동하는 것이 좋습니다. 비동기 요청은 대량의 데이터를 보다 효율적으로 처리하며 시간 제한 오류를 줄입니다.

지원되는 요청

새 비동기 예약 세부 정보 API를 호출할 때 다음 요청 URI를 사용합니다. 등록 번호를 billingAccountId로 사용해야 합니다. 다음 범위로 API를 호출할 수 있습니다.

등록: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

청구 계정 ID로 보고서 생성

예약 세부 정보 보고서를 생성하는 요청 샘플

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01 

POST 요청은 다음 응답에 설명된 대로 보고서 생성 상태를 폴링할 위치를 반환합니다.

샘플 응답

상태 코드 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2023-11-01
Retry-After: 60

상태 코드 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

보고서 생성 상태를 폴링하는 요청 샘플

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01 

폴링 응답 샘플

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

응답 본문 변경

다음 정보는 이전 동기 기반 예약 세부 정보 API의 응답 예입니다.

이전 응답

{
    "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/resourcegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

새 응답:

새 API는 자동으로 CSV 파일을 만듭니다. 다음 파일 필드를 참조하세요.

이전 속성	새 속성	주의
	InstanceFlexibilityGroup	새로운 인스턴스 크기 유연성 속성입니다.
	InstanceFlexibilityRatio	새로운 인스턴스 크기 유연성 속성입니다.
instanceId	InstanceName
	종류	새 속성입니다. 값은 None, Reservation 또는 IncludedQuantity입니다.
reservationId	ReservationId
reservationOrderId	ReservationOrderId
reservedHours	ReservedHours
skuName	SkuName
totalReservedQuantity	TotalReservedQuantity
usageDate	UsageDate
usedHours	UsedHours

관련 콘텐츠

• EA Reporting에서 ARM API로 마이그레이션 개요 문서를 참조하세요.