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.

Lihat juga