Udostępnij za pośrednictwem

Migrowanie z interfejsu API podsumowania salda umowy EA

  • Artykuł

Klienci z umową EA, którzy wcześniej korzystali z interfejsu API consumption.azure.com raportowania przedsiębiorstwa, aby uzyskać podsumowanie salda, muszą przeprowadzić migrację do zastępczego interfejsu API usługi Azure Resource Manager. Poniższe instrukcje ułatwiają migrację i omówienie wszelkich różnic kontraktów między starym interfejsem API a nowym interfejsem API.

Uwaga

Wszystkie interfejsy API raportowania przedsiębiorstwa platformy Azure są wycofane. Jak najszybciej należy przeprowadzić migrację do interfejsów API usługi Microsoft Cost Management.

Przypisywanie uprawnień do jednostki usługi w celu wywołania interfejsu API

Przed wywołaniem interfejsu API należy skonfigurować jednostkę usługi przy użyciu odpowiednich uprawnień. Jednostka usługi służy do wywoływania interfejsu API. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do interfejsów API usługi Cost Management.

Wywoływanie interfejsu API podsumowania salda

Podczas wywoływania nowego interfejsu API podsumowania salda użyj następujących identyfikatorów URI żądania. Numer rejestracji powinien być użyty jako identyfikator billingAccountId.

Obsługiwane żądania

Pobierz na potrzeby rejestracji

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

Zmiany treści odpowiedzi

Stara treść odpowiedzi:

{
  "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
    }
  ]
}

Nowa treść odpowiedzi:

Te same dane są teraz dostępne w polu właściwości nowej odpowiedzi interfejsu API. W przypadku niektórych nazw pól mogą wystąpić drobne zmiany pisowni.

{
  "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
      }
    ]
  }
}

Powiązana zawartość