Sdílet prostřednictvím

Migrace z rozhraní API souhrnu zůstatků EA

  • Článek

Zákazníci EA, kteří dříve používali rozhraní API pro generování sestav organizace consumption.azure.com k získání souhrnu zůstatku, musí migrovat na náhradní rozhraní API Azure Resource Manageru. Následující pokyny vám pomůžou migrovat a probrat všechny rozdíly mezi starým rozhraním API a novým rozhraním API.

Poznámka:

Všechna rozhraní API pro podnikové vytváření sestav Azure se vyřadí z důchodu. Co nejdříve byste měli migrovat na rozhraní API služby Microsoft Cost Management.

Přiřazení oprávnění instančnímu objektu pro volání rozhraní API

Před voláním rozhraní API je potřeba nakonfigurovat instanční objekt se správným oprávněním. Instanční objekt použijete k volání rozhraní API. Další informace najdete v tématu Přiřazení oprávnění k rozhraním API služby Cost Management.

Volání rozhraní API souhrnu zůstatku

Při volání nového rozhraní API pro souhrn zůstatků použijte následující identifikátory URI požadavků. Jako billingAccountId by se mělo použít vaše registrační číslo.

Podporované požadavky

Získání pro registraci

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

Změny textu odpovědi

Původní text odpovědi:

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

Nový text odpovědi:

Stejná data jsou nyní k dispozici v poli vlastností nové odpovědi rozhraní API. Je možné, že dojde k drobným změnám názvů některých polí.

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

Související obsah