Bagikan melalui

Migrasi dari API Ringkasan Saldo EA

  • Artikel

Pelanggan EA yang sebelumnya menggunakan API Enterprise Reporting consumption.azure.com untuk mendapatkan ringkasan saldonya perlu bermigrasi ke API Azure Resource Manager pengganti. Instruksi berikut membantu Anda memigrasikan dan mendiskusikan perbedaan kontrak apa pun antara API lama dan API baru.

Catatan

Semua API Pelaporan Azure Enterprise dihentikan. Anda harus bermigrasi ke API Microsoft Cost Management sesegera mungkin.

Menetapkan izin ke perwakilan layanan untuk memanggil API

Sebelum memanggil API, Anda perlu mengonfigurasi Perwakilan Layanan dengan izin yang benar. Anda menggunakan perwakilan layanan untuk memanggil API. Untuk informasi selengkapnya, lihat Menetapkan izin ke API Cost Management.

Memanggil API Ringkasan Saldo

Gunakan URI permintaan berikut saat memanggil API Ringkasan Saldo baru. Nomor pendaftaran Anda harus digunakan sebagai billingAccountId.

Permintaan yang didukung

Dapatkan untuk Pendaftaran

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

Perubahan isi respons

Isi respons lama:

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

Isi respons baru:

Data yang sama sekarang tersedia di bidang properti dari respons API baru. Mungkin ada perubahan kecil pada ejaan di beberapa nama bidang.

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

Konten terkait