Share via

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/00000000-0000-0000-0000-000000000000?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/00000000-0000-0000-0000-000000000000?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년 약정의 총 비용을 반영합니다.

참고: 계층 간 가격이 차등화된 서비스의 경우 단가는 사용량 세부 정보 다운로드의 유효 가격과 동일하지 않습니다.

서비스가 다중 계층 가격 책정인 경우 유효 가격은 계층 전체에서 혼합된 요금이며 계층별 단가를 표시하지 않습니다. 혼합 가격 또는 유효 가격은 (각 계층이 특정 단가를 가지는) 여러 계층에 걸친 소비 수량의 순 가격입니다.

관련 콘텐츠