Mendapatkan penggunaan Instans Reservasi pelanggan perusahaan
Catatan
Microsoft tidak lagi memperbarui API Pelaporan Enterprise. Sebagai gantinya, Anda harus menggunakan API Penggunaan Azure. API Penggunaan Azure Billing - Get Reserved Instance digantikan oleh Azure Consumption - Reservations Summaries API dan Azure Consumption - Reservations Details API.
API penggunaan Instans Reservasi menampilkan penggunaan pembelian Instans Reservasi dalam pendaftaran. Jika ada lebih dari satu Instans Reservasi dalam satu pendaftaran, maka Anda juga bisa mendapatkan penggunaan semua pembelian Instans Reservasi dengan menggunakan API ini.
Permintaan detail penggunaan Instans Reservasi
Lihat artikel Gambaran Umum API Pelaporan untuk pelanggan Perusahaan untuk mempelajari tentang properti header umum yang diperlukan.
| Metode | URI Permintaan |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationdetails?startDate={yyyy-mm-dd}&endDate={yyyy-mm-dd} |
Respons detail penggunaan
[{
"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
}
Definisi properti respons
| Nama Properti | Jenis | Deskripsi |
|---|---|---|
| reservationOrderId | string | ID pesanan reservasi adalah pengidentifikasi untuk pembelian reservasi. Setiap ID pesanan reservasi mewakili satu transaksi pembelian. Pesanan reservasi berisi reservasi. Pesanan reservasi menentukan ukuran dan wilayah VM untuk reservasi. |
| reservationId | string | ID reservasi adalah pengidentifikasi reservasi dalam pesanan reservasi. Setiap reservasi adalah pengelompokan untuk menerapkan cakupan manfaat dan juga menentukan jumlah instans tempat manfaat reservasi dapat diterapkan. |
| usageDate | string | Tanggal terjadinya konsumsi. |
| skuName | string | Ini adalah nama Azure Resource Manager Sku. Ini dapat digunakan untuk bergabung dengan bidang servicetype di additionalInfo dalam rekaman penggunaan. |
| instanceId | string | Pengidentifikasi ini adalah nama sumber daya atau ID Sumber Daya yang sepenuhnya memenuhi syarat. |
| totalReservedQuantity | string | Ini adalah jumlah total instans yang dicadangkan untuk ID reservasi. |
| reservedHours | desimal | Ini adalah total jam yang dipesan untuk hari itu. Misalnya, jika reservasi untuk 1 instans dilakukan pada pukul 13.00, jam yang dipesan akan menjadi 11 jam untuk hari pertama dan 24 jam untuk hari berikutnya. |
| usedHours | desimal | Ini adalah total jam yang digunakan oleh instans. |
Permintaan ringkasan penggunaan Instans Cadangan
Lihat artikel Gambaran Umum API Pelaporan untuk pelanggan Perusahaan untuk mempelajari tentang properti header umum yang diperlukan. API mendukung pemanfaatan reservasi untuk butir harian dan bulanan. Parameter Startdate dan EndDate tidak diperlukan untuk data bulanan.
| Metode | URI Permintaan |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationsummaries?grain=daily&startdate={yyyy-mm-dd}&enddate={yyyy-mm-dd} |
Respons ringkasan penggunaan
[
{
"reservationOrderId": "00000000-0000-0000-0000-000000000000",
"reservationId": "00000000-0000-0000-0000-000000000000",
"skuName": "Standard_F1s",
"reservedHours": 24,
"usageDate": "2018-05-01T00:00:00",
"usedHours": 23,
"minUtilizationPercentage": 0,
"avgUtilizationPercentage": 95.83,
"maxUtilizationPercentage": 100
}
]
Definisi properti respons
| Nama Properti | Jenis | Deskripsi |
|---|---|---|
| reservationOrderId | string | ID pesanan reservasi adalah pengidentifikasi untuk pembelian reservasi. Setiap ID pesanan reservasi mewakili satu transaksi pembelian. Pesanan reservasi berisi reservasi. Pesanan reservasi menentukan ukuran dan wilayah VM untuk reservasi. |
| reservationId | string | ID reservasi adalah pengidentifikasi reservasi dalam pesanan reservasi. Setiap reservasi adalah pengelompokan untuk menerapkan cakupan manfaat dan juga menentukan jumlah instans tempat manfaat reservasi dapat diterapkan. |
| usageDate | string | Tanggal terjadinya konsumsi. |
| skuName | string | String yang mewakili sumber daya yang dibeli. |
| reservedHours | desimal | Total jam yang dipesan untuk hari itu. Misalnya, jika reservasi untuk 1 instans dilakukan pada pukul 13.00, jam yang dipesan akan menjadi 11 jam untuk hari pertama dan 24 jam untuk hari berikutnya. |
| usedHours | desimal | Total jam yang digunakan oleh instans. |
| minUtilizationPercentage | double | Persentase pemanfaatan minimum pada hari tertentu. Jika Anda membeli satu reservasi dan memiliki satu VM yang berjalan selama 23 jam, nilainya adalah 0. |
| avgUtilizationPercentage | double | Persentase pemanfaatan rata-rata pada hari tertentu. Jika Anda membeli satu reservasi dan memiliki satu VM yang berjalan selama 23 jam, nilainya adalah 23/24. |
| MaxUtilizationPercentage | double | Persentase pemanfaatan maksimum pada hari tertentu. Jika Anda membeli satu reservasi dan memiliki satu VM yang berjalan selama 23 jam, bidang akan menjadi 1. |