Bagikan melalui

Migrasikan dari API Detail Penggunaan Instans Cadangan EA

  • Artikel

Pelanggan EA yang sebelumnya menggunakan API consumption.azure.com Pelaporan Enterprise untuk mendapatkan detail penggunaan instans cadangan perlu bermigrasi ke API Azure Resource Manager. 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.

Panggil API detail penggunaan instans Cadangan

Microsoft tidak memperbarui API Detail Cadangan berbasis-sinkron yang lebih lama. Sebaiknya pindah ke pola panggilan API asinkron yang didukung SPN yang lebih baru sebagai bagian dari migrasi. Permintaan asinkron lebih baik dalam menangani data berjumlah besar dan mengurangi kesalahan timeout.

Permintaan yang didukung

Gunakan URI permintaan berikut saat memanggil API Detail Reservasi Asinkron yang baru. Nomor pendaftaran Anda harus digunakan sebagai billingAccountId. Anda dapat memanggil API dengan cakupan berikut:

Pendaftaran: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Membuat laporan dengan ID akun penagihan

Contoh permintaan untuk membuat laporan detail reservasi

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01

Permintaan POST mengembalikan lokasi untuk melakukan polling status pembuatan laporan seperti yang diuraikan dalam respons berikut:

Respon sampel

Kode status 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2023-11-01
Retry-After: 60

Kode status 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Contoh permintaan ke status pembuatan laporan polling

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01

Contoh respons polling

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Perubahan isi respons

Informasi berikut adalah contoh respons API Detail Reservasi berbasis sinkron yang lebih lama.

Respons lama:

{
    "reservationOrderId": "00000000-0000-0000-0000-000000000000",
    "reservationId": "00000000-0000-0000-0000-000000000000",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Respons baru:

API baru membuat file CSV untuk Anda. Lihat bidang file berikut ini.

Properti lama Properti baru Catatan
InstanceFlexibilityGroup Properti fleksibilitas ukuran instans baru.
InstanceFlexibilityRatio Properti fleksibilitas ukuran instans baru.
instansId InstanceName
Kind Ini adalah properti baru. Nilainya adalah None, Reservation, atau IncludedQuantity.
reservationId ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

Konten terkait