Penggunaan Azure
API Azure Consumption memberi Anda akses terprogram ke data biaya dan penggunaan untuk sumber daya Azure Anda. API saat ini hanya mendukung Pendaftaran Perusahaan, langganan Web Direct (dengan beberapa pengecualian), dan langganan paket CSP Azure. API ini terus diperbarui untuk mendukung jenis langganan Azure lainnya.
API Konsumsi Azure menyediakan akses ke:
- Hanya Pelanggan Perusahaan
- Lembar harga
- Anggaran
- Forecasts
- Balances
- Tag
- Tag Biaya
- Pelanggan Enterprise dan Web Direct
- Detail Reservasi
- Ringkasan Reservasi
- Biaya Azure Marketplace
- Detail Penggunaan
- Rekomendasi Reservasi
Daftar Jenis Langganan yang Tidak Didukung
- MS-AZR-0145P (Penyedia Solusi Cloud)
- MS-AZR-0146P (Penyedia Solusi Cloud)
- MS-AZR-159P (Penyedia Solusi Cloud)
- MS-AZR-0036P (sponsor)
- MS-AZR-0143P (sponsor)
- MS-AZR-0015P (internal)
- MS-AZR-0144P (DreamSpark)
Bekerja dengan periode penagihan dan rentang tanggal
Detail Penggunaan dan Biaya Marketplace menerima periode penagihan atau rentang tanggal untuk menentukan tanggal mulai dan berakhir untuk data penggunaan.
Berikut adalah perilaku API berdasarkan periode penagihan dan rentang tanggal dalam permintaan.
| Periode penagihan ada dalam permintaan | Tanggal mulai ada dalam permintaan | Tanggal akhir yang ada dalam permintaan | Perilaku API |
|---|---|---|---|
| tidak | tidak | tidak | Data untuk periode penagihan saat ini dikembalikan sebagai respons |
| tidak | ya | tidak | Data untuk periode penagihan saat ini dikembalikan sebagai respons |
| tidak | tidak | ya | Data untuk periode penagihan saat ini dikembalikan sebagai respons |
| tidak | ya | ya | Data untuk Tanggal Mulai dan Selesai yang ditentukan dikembalikan sebagai respons |
| ya | tidak | tidak | Data untuk periode penagihan yang ditentukan dikembalikan sebagai respons |
| ya | ya | tidak | Data untuk periode penagihan yang ditentukan dikembalikan sebagai respons |
| ya | tidak | ya | Data untuk periode penagihan yang ditentukan dikembalikan sebagai respons |
| ya | ya | ya | Data untuk Tanggal Mulai dan Akhir yang ditentukan dikembalikan sebagai respons, periode penagihan yang disediakan diabaikan |
Rentang tanggal maksimum yang diizinkan adalah 12 bulan dalam satu permintaan dan data tersedia mulai 1 Mei 2014 atau yang lebih baru.
Mendapatkan daftar periode penagihan
Untuk memberikan periode penagihan yang valid dalam permintaan, klien harus terlebih dahulu mendapatkan daftar periode penagihan yang tersedia berdasarkan langganan, menggunakan API berikut
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview
Dengan menggunakan daftar ini, klien dapat memilih periode penagihan tertentu untuk mendapatkan data konsumsi.
Data Yang Terlambat Tiba
Untuk mengakomodasi layanan pihak ketiga, yang memiliki keterlambatan dalam pelaporan penggunaan, tanggal penggunaan yang dilaporkan diatur ke waktu di mana data penggunaan dikirim, dibandingkan dengan ketika penggunaan aktual terjadi yaitu, waktu konsumsi.
Akibatnya, penggunaan akan dinilai untuk dan diterapkan pada waktu yang dilaporkan. Untuk mewakili waktu konsumsi aktual, properti . Bidang AdditionalProperties sekarang akan berisi dua properti tambahan. ConsumptionBeginTime dan ConsumptionEndTime adalah bidang baru yang sesuai dengan jendela waktu konsumsi aktual.
Perubahan ini akan menghasilkan beberapa skenario yang perlu ditangani saat memanggil API detail penggunaan:
Pelaporan Akhir Bulan: Untuk penggunaan yang terjadi selama sebulan, tetapi dilaporkan selama bulan berikutnya, pelanggan harus melihat bidang additionalProperties untuk menetapkan penggunaan, ke bulan yang sesuai.
Detail Penggunaan Kueri: Saat mengkueri API detail penggunaan dengan rentang tanggal, kueri hanya berlaku untuk tanggal laporan penggunaan dan bukan waktu konsumsi di bidang additionalProperties . Bagi pelanggan yang ingin memetakan detail penggunaan ke faktur, pembaruan ini tidak memengaruhi proses karena faktur akan memproses penggunaan berdasarkan tanggal laporan penggunaan. Bagi pelanggan, mencari untuk memetakan detail penggunaan ke tanggal/bulan kalender tertentu, pembaruan ini adalah perubahan yang melanggar dan untuk skenario ini tanggal laporan penggunaan tidak dapat digunakan dan tanggal penggunaan terjadi, di bagian additionalProperties harus digunakan.
Contoh Panggilan untuk Detail Tambahan:
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties
Cuplikan Respons Sampel:
"properties": {
"billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
"usageStart":"2018-05-01T00:00:00.0000000Z",
"usageEnd":"2018-05-01T23:59:59.0000000Z",
"instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
"instanceName":"{id}",
"instanceLocation":"SouthCentralUS",
"meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
"usageQuantity":0.002065,
"pretaxCost":0,
"currency":"USD",
"additionalProperties": {
"Provider": "1",
"ConsumptionBeginTime": "2018-05-01T19:00:00",
"ConsumptionEndTime": "2018-05-01T20:00:00"
}
}
Lihat juga
Untuk informasi selengkapnya tentang menggunakan API ini di salah satu SDK khusus bahasa, kunjungi yang berikut ini