다음을 통해 공유


EA 잔액 요약 API에서 마이그레이션

잔액 요약을 가져오기 위해 이전에 Enterprise Reporting 사용량.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 호출

새 잔액 요약 API를 호출할 때 다음 요청 URI를 사용합니다. 등록 번호를 billingAccountId로 사용해야 합니다.

지원되는 요청

등록 가져오기

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances?api-version=2023-05-01

응답 본문 변경

이전 응답 본문:

{
  "id": "enrollments/100/billingperiods/201507/balancesummaries",
  "billingPeriodId": 201507,
  "currencyCode": "USD",
  "beginningBalance": 0,
  "endingBalance": 1.1,
  "newPurchases": 1,
  "adjustments": 1.1,
  "utilized": 1.1,
  "serviceOverage": 1,
  "chargesBilledSeparately": 1,
  "totalOverage": 1,
  "totalUsage": 1.1,
  "azureMarketplaceServiceCharges": 1,
  "newPurchasesDetails": [
    {
      "name": "",
      "value": 1
    }
  ],
  "adjustmentDetails": [
    {
      "name": "Promo Credit",
      "value": 1.1
    },
    {
      "name": "SIE Credit",
      "value": 1
    }
  ]
}

새 응답 본문:

이제 새 API 응답의 속성 필드에서 동일한 데이터를 사용할 수 있습니다. 일부 필드 이름의 철자가 변경될 수 있습니다.

{
  "id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/balances/balanceId1",
  "name": "balanceId1",
  "type": "Microsoft.Consumption/balances",
  "properties": {
    "currency": "USD  ",
    "beginningBalance": 3396469.19,
    "endingBalance": 2922371.02,
    "newPurchases": 0,
    "adjustments": 0,
    "utilized": 474098.17,
    "serviceOverage": 0,
    "chargesBilledSeparately": 0,
    "totalOverage": 0,
    "totalUsage": 474098.17,
    "azureMarketplaceServiceCharges": 609.82,
    "billingFrequency": "Month",
    "priceHidden": false,
    "overageRefund": 2012.61,
    "newPurchasesDetails": [
      {
        "name": "Promo Purchase",
        "value": 1
      }
    ],
    "adjustmentDetails": [
      {
        "name": "Promo Credit",
        "value": 1.1
      },
      {
        "name": "SIE Credit",
        "value": 1
      }
    ]
  }
}