다음을 통해 공유


사용량 세부 정보 API에서 마이그레이션

이 문서에서는 더 이상 사용되지 않는 사용량 세부 정보 API에서 마이그레이션하는 방법에 대해 설명합니다. 정확한 사용 중단 날짜는 아직 결정되지 않았습니다. 이 API를 사용하여 보고 파이프라인을 구축하지 말고 가능한 한 빨리 마이그레이션하는 것이 좋습니다.

인증에 API 키를 사용하고 consumption.azure.com URI 엔드포인트를 통해 액세스되는 EA(기업계약) 보고 API는 사용 중지됩니다. 이러한 API를 사용하는 EA 고객은 Cost Management 비용 세부 정보 API로 마이그레이션해야 합니다. 이러한 이전 EA 보고 API는 기업계약을 체결한 고객만 사용할 수 있습니다.

Consumption 사용량 세부 정보 API를 사용하는 경우 Cost Management 비용 세부 정보 API로 반드시 마이그레이션할 필요는 없지만 그렇게 하는 것이 좋습니다.

Consumption 및 Cost Management API는 EA MCA(Microsoft 고객 계약) 고객 모두 사용할 수 있습니다. 따라서 EA에 남아 있는 Azure Government 고객은 부정적인 영향을 받지 않습니다.

EA에서 MCA로 마이그레이션하는 경우 EA 보고 사용량 세부 정보 API에서 Cost Management 비용 세부 정보 API로 이동하고 내보내기를 사용하는 것이 좋습니다.

마이그레이션 대상

워크로드에 적합한 솔루션을 선택하기 전에 비용 세부 정보 솔루션 선택 문서를 참조하세요. 일반적으로 지속적인 데이터 수집이 필요하거나 대규모 월별 사용량 세부 정보 데이터 세트가 있는 경우 내보내기를 권장합니다. 자세한 내용은 사용 세부 정보 데이터 수집을 참조하세요.

사용량 세부 정보 데이터 세트가 작거나 내보내기로 충족되지 않는 시나리오가 있는 경우 비용 세부 정보 보고서를 대신 사용하는 것이 좋습니다. 자세한 내용은 요청 시 적은 비용 데이터 세트 가져오기를 참조하세요.

참고 항목

비용 세부 정보 보고서는 기업계약 또는 Microsoft 고객 계약을 체결한 고객에게만 제공됩니다. MSDN, 종량제 또는 Visual Studio 구독이 있는 경우 내보내기로 마이그레이션하거나 사용량 세부 정보 API를 계속 사용할 수 있습니다.

마이그레이션 이점

새로운 솔루션은 사용량 세부 정보 API에 비해 많은 이점을 제공합니다. 다음은 요약입니다.

  • 모든 사용량 세부 정보에 대한 단일 데이터 세트 - Azure 및 Azure Marketplace 사용량 세부 정보가 하나의 데이터 세트로 병합되었습니다. 이로 인해 모든 요금을 확인하기 위해 호출해야 하는 API 수가 줄어듭니다.
  • 확장성 - Marketplace API는 Azure 사용량이 증가함에 따라 확장할 수 없는 호출 패턴을 촉진하기 때문에 더 이상 사용되지 않습니다. 클라우드에 더 많은 리소스를 배포하면 사용량 세부 정보 데이터 세트가 커질 수 있습니다. Marketplace API는 페이지가 매겨진 동기 API이므로 네트워크를 통해 높은 효율성과 안정성으로 대용량 데이터를 효과적으로 전송하는 데 최적화되어 있지 않습니다. 내보내기 및 비용 세부 정보 API는 비동기식입니다. 네트워크를 통해 직접 다운로드할 수 있는 CSV 파일을 제공합니다.
  • API 개선 - 내보내기 및 비용 세부 정보 API는 Azure에서 지원되는 솔루션입니다. 모든 새로운 기능이 이 솔루션으로 통합되고 있습니다.
  • 스키마 일관성 - 비용 세부 정보 보고서 및 내보내기는 일치하는 필드가 있는 파일을 제공하므로 시나리오에 따라 한 솔루션에서 다른 솔루션으로 이동할 수 있습니다.
  • 비용 할당 통합 - 내보내기 또는 비용 세부 정보 API를 사용하는 기업계약 및 Microsoft 고객 계약 고객은 구성한 비용 할당 규칙과 관련된 요금을 볼 수 있습니다. 비용 할당에 대한 자세한 내용은 비용 할당을 참조하세요.

필드 차이

다음 표에는 사용량 세부 정보 API와 내보내기/비용 세부 정보 API 간의 필드 차이점이 요약되어 있습니다. 내보내기 및 비용 세부 정보 API는 사용량 API에서 제공하는 페이지를 매긴 JSON 응답 대신 CSV 파일 다운로드를 제공합니다.

기업계약 필드 매핑

사용량 세부 정보 API를 사용하는 기업계약 고객에게는 legacy 종류의 사용량 세부 정보 레코드가 있습니다. 모든 기업계약 고객에게는 사용되는 기본 청구 시스템으로 인해 이러한 종류의 레코드가 있습니다. 다음은 레거시 사용량 세부 정보 레코드의 예입니다.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

전체 예제 레거시 사용 세부 정보 레코드는 사용량 세부 정보 - 목록 - REST API(Azure 사용량)에 표시됩니다.

다음 표는 이전 필드와 새 필드 간의 매핑을 제공합니다. 내보내기 및 비용 세부 정보 API에서 생성된 CSV 파일에서 새 속성을 사용할 수 있습니다. 필드에 대한 자세한 내용은 사용량 세부 정보 필드 이해를 참조하세요.

굵은 속성 이름은 변경되지 않습니다.

이전 속성 새 속성
accountName AccountName
AccountOwnerId AccountOwnerId
additionalInfo AdditionalInfo
AvailabilityZone AvailabilityZone
billingAccountId BillingAccountId
billingAccountName BillingAccountName
billingCurrency BillingCurrencyCode
billingPeriodEndDate BillingPeriodEndDate
billingPeriodStartDate BillingPeriodStartDate
billingProfileId BillingProfileId
billingProfileName BillingProfileName
chargeType ChargeType
consumedService ConsumedService
비용 CostInBillingCurrency
costCenter CostCenter
date 날짜
effectivePrice EffectivePrice
frequency 빈도
invoiceSection InvoiceSectionName
InvoiceSectionId InvoiceSectionId
isAzureCreditEligible IsAzureCreditEligible
meterCategory MeterCategory
meterId MeterId
meterName MeterName
MeterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId OfferId
partNumber PartNumber
PayGPrice PayGPrice
PlanName PlanName
PricingModel PricingModel
product ProductName
ProductOrderId ProductOrderId
ProductOrderName ProductOrderName
PublisherName PublisherName
PublisherType PublisherType
quantity 수량
ReservationId ReservationId
ReservationName ReservationName
resourceGroup ResourceGroup
resourceId ResourceId
resourceLocation ResourceLocation
resourceName에 대한 추천 사항을 찾았음 ResourceName
serviceFamily ServiceFamily
ServiceInfo1 ServiceInfo1
ServiceInfo2 ServiceInfo2
subscriptionId SubscriptionId
subscriptionName SubscriptionName
태그 태그
기간 용어
unitOfMeasure UnitOfMeasure
unitPrice 단가
CostAllocationRuleName CostAllocationRuleName

Microsoft 고객 계약 필드 매핑

사용량 세부 정보 API를 사용하는 Microsoft 고객 계약 고객에게는 modern 종류의 사용량 세부 정보 레코드가 있습니다. 모든 Microsoft 고객 계약 고객에게는 사용되는 기본 청구 시스템으로 인해 이러한 종류의 레코드가 있습니다. 다음은 MCA 사용량 세부 정보 레코드의 예입니다.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

전체 예제 레거시 사용 세부 정보 레코드는 사용량 세부 정보 - 목록 - REST API(Azure 사용량)에 표시됩니다.

이전 필드와 새 필드 간의 매핑이 다음 표에 나와 있습니다. 내보내기 및 비용 세부 정보 API에서 생성된 CSV 파일에서 새 속성을 사용할 수 있습니다. 솔루션 간의 차이로 인해 매핑이 필요한 필드는 굵은 텍스트로 표시됩니다.

자세한 내용은 사용량 세부 정보 필드 이해를 참조하세요.

이전 속성 새 속성
invoiceId invoiceId
previousInvoiceId previousInvoiceId
billingAccountId billingAccountId
billingAccountName billingAccountName
billingProfileId billingProfileId
billingProfileName billingProfileName
invoiceSectionId invoiceSectionId
invoiceSectionName invoiceSectionName
partnerTenantId partnerTenantId
partnerName partnerName
resellerName resellerName
resellerMpnId resellerMpnId
customerTenantId customerTenantId
customerName customerName
costCenter costCenter
billingPeriodEndDate billingPeriodEndDate
billingPeriodStartDate billingPeriodStartDate
servicePeriodEndDate servicePeriodEndDate
servicePeriodStartDate servicePeriodStartDate
date date
serviceFamily serviceFamily
productOrderId productOrderId
productOrderName productOrderName
consumedService consumedService
meterId meterId
meterName meterName
meterCategory meterCategory
meterSubCategory meterSubCategory
meterRegion meterRegion
productIdentifier ProductId
product ProductName
subscriptionGuid SubscriptionId
subscriptionName subscriptionName
publisherType publisherType
publisherId publisherId
publisherName publisherName
resourceGroup resourceGroupName
INSTANCENAME ResourceId
resourceLocationNormalized location
resourceLocation location
effectivePrice effectivePrice
quantity quantity
unitOfMeasure unitOfMeasure
chargeType chargeType
billingCurrencyCode billingCurrency
pricingCurrencyCode pricingCurrency
costInBillingCurrency costInBillingCurrency
costInPricingCurrency costInPricingCurrency
costInUsd costInUsd
paygCostInBillingCurrency paygCostInBillingCurrency
paygCostInUSD paygCostInUsd
exchangeRatePricingToBilling exchangeRatePricingToBilling
exchangeRateDate exchangeRateDate
isAzureCreditEligible isAzureCreditEligible
serviceInfo1 serviceInfo1
serviceInfo2 serviceInfo2
additionalInfo additionalInfo
tags tags
partnerEarnedCreditRate partnerEarnedCreditRate
partnerEarnedCreditApplied partnerEarnedCreditApplied
marketPrice PayGPrice
frequency frequency
용어 용어
reservationId reservationId
reservationName reservationName
pricingModel pricingModel
unitPrice unitPrice
exchangeRatePricingToBilling exchangeRatePricingToBilling