Condividi tramite

Eseguire la migrazione dall'API Riepilogo saldi EA

  • Articolo

I clienti EA che in precedenza usavano l'API di creazione di report Enterprise consumption.azure.com per ottenere il riepilogo dei saldi devono eseguire la migrazione a un'API di Azure Resource Manager sostitutiva. Le istruzioni seguenti consentono di eseguire la migrazione e discutere le differenze di contratto tra l'API precedente e la nuova API.

Nota

Tutte le API di creazione report enterprise di Azure vengono ritirati. È consigliabile eseguire la migrazione alle API di Gestione costi Microsoft il prima possibile.

Assegnare autorizzazioni a un'entità servizio per chiamare l'API

Prima di chiamare l'API, è necessario configurare un'entità servizio con l'autorizzazione corretta. L'entità servizio viene utilizzata per chiamare l'API. Per altre informazioni, vedere Assegnare autorizzazioni alle API di Gestione costi.

Chiamare l'API Riepilogo saldi

Usare gli URI di richieste seguenti per chiamare la nuova API di riepilogo saldi. Per billingAccountId è necessario usare il proprio numero di registrazione.

Richieste supportate

Ottenere i saldi per la registrazione

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

Modifiche del corpo della risposta

Vecchio corpo della risposta:

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

Nuovo corpo della risposta:

Gli stessi dati sono ora disponibili nel campo properties della risposta dell'API. Potrebbero essere presenti modifiche secondarie in alcuni nomi dei campi.

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

Contenuto correlato