Melihat dan mengambil data penggunaan
Penyedia istilah berlaku untuk administrator layanan dan penyedia yang didelegasikan. Operator Azure Stack Hub dan penyedia yang didelegasikan dapat menggunakan Antarmuka Pemrograman Aplikasi (API) penggunaan penyedia untuk melihat penggunaan penyewa langsung mereka. Misalnya, seperti yang ditunjukkan pada diagram berikut, P0 dapat memanggil API penyedia untuk mendapatkan informasi penggunaan langsung pada P1 dan P2, dan P1 dapat memanggil informasi penggunaan pada P3 dan P4.
Referensi panggilan Antarmuka Pemrograman Aplikasi (API)
Permintaan
Permintaan mendapatkan detail konsumsi untuk langganan yang diminta dan untuk jangka waktu yang diminta. Tidak ada isi permintaan.
Antarmuka Pemrograman Aplikasi penggunaan ini adalah Antarmuka Pemrograman Aplikasi penyedia, sehingga pemanggil harus diberi peran Pemilik, Kontributor, atau Pembaca dalam langganan penyedia.
Metode: GET
https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value}
Argumen
| Argumen | Keterangan |
|---|---|
armendpoint |
Titik akhir Azure Resource Manager dari lingkungan Azure Stack Hub Anda. Konvensi Azure Stack Hub adalah bahwa nama titik akhir Azure Resource Manager dalam format https://adminmanagement.{domain-name}. |
subId |
ID Langganan pengguna yang melakukan panggilan. |
reportedStartTime |
Waktu mulai kueri. Nilai untuk DateTime harus dalam Waktu Universal Terkoordinasi (UTC) dan di awal jam; misalnya pukul 13.00. Untuk agregasi harian, atur nilai ini ke UTC tengah malam. |
reportedEndTime |
Waktu akhir kueri. Batasan yang berlaku untuk reportedStartTime juga berlaku untuk argumen ini. Nilai untuk reportedEndTime tidak boleh di masa mendatang, atau tanggal saat ini. Jika ya, hasilnya akan diatur ke "pemrosesan tidak selesai." |
aggregationGranularity |
Parameter opsional yang memiliki dua nilai potensial yang berbeda: daily dan hourly. Seperti yang disarankan oleh nilai, satu menampilkan data dalam granuralitas harian, dan yang lainnya adalah resolusi per jam. |
subscriberId |
ID Langganan. Untuk mendapatkan data yang difilter, ID langganan penyewa langsung dari penyedia diperlukan. Jika tidak ada parameter ID langganan yang ditentukan, panggilan akan menampilkan data penggunaan untuk semua penyewa langsung penyedia. |
api-version |
Versi protokol yang digunakan untuk membuat permintaan ini. Nilai ini diatur menjadi 2015-06-01-preview. |
continuationToken |
Token diambil dari panggilan terakhir ke penyedia API penggunaan. Token ini diperlukan ketika respons lebih dari 1.000 baris. Hal ini bertindak sebagai marka buku untuk kemajuan. Jika token tidak ada, data diambil dari awal hari atau jam, berdasarkan granuralitas yang diteruskan. |
Respons
GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0
| Argumen | Keterangan |
|---|---|
id |
ID unik dari agregat penggunaan. |
name |
Nama agregat penggunaan. |
type |
Definisi sumber daya. |
subscriptionId |
Pengidentifikasi langganan pengguna Azure Stack Hub. |
usageStartTime |
Waktu mulai UTC dari wadah penggunaan tempat agregat penggunaan ini berada. |
usageEndTime |
Waktu berakhir UTC dari wadah penggunaan tempat agregat penggunaan ini berada. |
instanceData |
Pasangan kunci-nilai dari detail instans (dalam format baru): resourceUri: ID sumber daya yang sepenuhnya memenuhi syarat, yang mencakup grup sumber daya dan nama instans. location: Wilayah tempat layanan ini dijalankan. tags: Tag sumber daya yang ditentukan oleh pengguna. additionalInfo: Detail selengkapnya tentang sumber daya yang digunakan; misalnya, versi OS atau jenis gambar. |
quantity |
Jumlah konsumsi sumber daya yang terjadi dalam jangka waktu ini. |
meterId |
ID unik untuk sumber daya yang digunakan (juga disebutResourceID). |
Mengambil informasi penggunaan
PowerShell
Untuk membuat data penggunaan, Anda harus memiliki sumber daya yang berjalan dan aktif menggunakan sistem. Misalnya, mesin virtual aktif, atau akun penyimpanan yang berisi data.
Gunakan cmdlet PowerShell berikut untuk melihat data penggunaan:
- Menginstal PowerShell untuk Azure Stack Hub.
- Konfigurasikan pengguna Azure Stack Hub atau lingkungan PowerShell operator Azure Stack Hub.
- Untuk mengambil data penggunaan, panggil cmdlet PowerShell Get-AzsSubscriberUsage:
Get-AzsSubscriberUsage -ReportedStartTime