Bagikan melalui

Azure Quota Service API

  • Artikel

AZURE Quota Service REST API dirancang untuk melihat dan mengelola kuota untuk penyedia sumber daya Azure.

Penting

AZURE Quota Service API adalah Pratinjau Umum

Versi Azure Quota API baru adalah pratinjau publik. API ini menggunakan Penyedia Sumber Daya Microsoft.Quota, mendukung komputer virtual Azure (core/vCPU), Azure Machine Learning (dedicated/vCPU), Jaringan, Azure HPC Cache, Penyimpanan, dan layanan Azure Purview.

Kuota adalah batas layanan atau jatah yang ditetapkan pada sumber daya di langganan Azure Anda. Setiap layanan Azure menentukan kuotanya dan menentukan nilai defaultnya. Untuk informasi selengkapnya tentang kuota Microsoft Azure yang paling umum, lihat Batas, kuota, dan batasan langganan dan layanan Azure.

Menggunakan API Kuota

Dengan Api Kuota, Anda dapat:

  1. Dapatkan kuota dan penggunaan sumber daya saat ini.
  2. Dapatkan daftar kuota dan penggunaan semua sumber daya saat ini.
  3. Membuat atau memperbarui kuota sumber daya.
  4. Dapatkan status permintaan kuota untuk sumber daya.
  5. Mendapatkan daftar semua permintaan kuota sumber daya selama satu tahun

Cakupan dan panggilan API PUT Kuota

Permintaan PUT API Kuota mencakup parameter "cakupan" yang dapat disesuaikan agar selaras dengan persyaratan penyedia sumber daya yang mencari peningkatan kuota, memastikan panggilan API tetap seragam.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Penyedia Sumber Daya Cakupan
Microsoft.Compute subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{azure location}
Microsoft.HDInsight subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{azure location}
Microsoft.MachineLearningService subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningService/locations/{azure location}
Microsoft.Network subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{azure location}
Microsoft.Purview subscriptions/{subscriptionId}/providers/Microsoft.Purview/locations/{azure location}

Catatan: Contoh panggilan PUT untuk komputasi dapat ditemukan di sini.

Prasyarat

Penting

Sebelum dapat menggunakan Api Kuota, Anda harus:

Mendaftarkan penyedia sumber daya Kuota Microsoft

Untuk mendaftarkan penyedia sumber daya Kuota Microsoft, gunakan perintah PowerShell di bawah ini:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Ini mengembalikan hasil yang mirip dengan output di bawah ini:

ProviderNamespace : Microsoft.Quota
RegistrationState : Registering
ResourceTypes     : {usages, quotas, quotaRequests, operationsStatus...}
Locations         : {West Europe, East US, South Central US...}

Setelah penyedia sumber daya Microsoft.Quota terdaftar, RegistrationState akan diatur ke Registered. Untuk informasi selengkapnya tentang mengelola penyedia sumber daya Azure, lihat Penyedia sumber daya Azure.

Pembatasan

Setiap panggilan API tingkat langganan dan tingkat penyewa dapat dibatasi jika Anda mengirim terlalu banyak permintaan API. Jika panggilan API Anda dibatasi, Anda akan mendapatkan pesan kesalahan yang menyatakan bahwa server menolak permintaan API. Anda dapat mencoba kembali panggilan API setelah beberapa waktu berlalu.

Untuk detail tentang pembatasan API, cara memecahkan masalah pembatasan, dan cara menghindari pembatasan, lihat Memecahkan masalah kesalahan pembatasan di Azure.

Peran Operator Permintaan Kuota

Operator Permintaan Kuota adalah peran bawaan Azure yang disesuaikan untuk operasi kuota. Ini memberikan izin untuk membaca dan membuat permintaan kuota, mendapatkan status permintaan kuota, dan membuat tiket dukungan. Tetapkan peran ini kepada pengguna, grup, perwakilan layanan, identitas terkelola, dan aplikasi yang melakukan operasi kuota. Sebagai referensi, ID peran Operator Permintaan Kuota adalah 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Peran Operator Permintaan Kuota diperluas untuk menyertakan Izin Penyedia Sumber Kuota.

Praktik terbaik API Kuota

  1. Memantau pemanfaatan kuota: Gunakan API kuota Azure untuk melacak penggunaan kuota Anda secara efektif. API ini menyediakan informasi real time tentang penggunaan Anda saat ini dan kuota yang tersedia untuk kombinasi langganan, keluarga VM, dan wilayah tertentu. Sangat penting untuk secara teratur memeriksa pemanfaatan kuota Anda sebelum mempertimbangkan kenaikan kuota.

  2. Meminta penambahan kuota: Jika pemanfaatan kuota Anda melebihi target yang telah ditentukan sebelumnya, mulai permintaan peningkatan kuota menggunakan API kuota Azure untuk membawa pemanfaatan Anda kembali sejalan dengan tujuan Anda. Prosesnya mudah - cukup kirim permintaan API yang menguraikan peningkatan kuota yang diinginkan. Misalnya, jika pemanfaatan target untuk kuota keluarga VM Dv2 di Eropa Utara, di bawah "subscription1," ditetapkan pada 80%, dan pemantauan API kuota Azure Anda menunjukkan pemanfaatan aktual 85%, kirimkan peningkatan kuota 10% hingga 20%.

Tip

Dianjurkan untuk meminta peningkatan kuota 10% hingga 20% dari utlisasi sumber daya karena menyediakan buffer resonalble untuk lonjakan penggunaan sumber daya yang tidak terduga, memastikan bahwa Anda tidak akan segera mencapai batas kuota baru Anda setelah peningkatan . Pendekatan ini meminimalkan kebutuhan panggilan API yang sering untuk meminta kuota tambahan, meningkatkan peluang persetujuan Anda.

  1. Respnose peningkatan kuota: Setelah mengirimkan permintaan penambahan kuota, Anda akan menerima respons yang menunjukkan apakah permintaan Anda telah disetujui atau ditolak. Jika terjadi penolakan, Anda dapat memulai tindak lanjut dengan mencatat permintaan dukungan menggunakan REST API Dukungan Azure atau menggunakan permintaan dukungan baru di portal Azure, termasuk spesifik permintaan peningkatan kuota yang ditolak dan alasan pertanyaan Anda.

Pemecahan masalah kesalahan API Kuota

Gunakan tabel berikut untuk memecahkan masalah kesalahan yang mungkin Anda dapatkan saat menggunakan API Kuota.

Kode kesalahan Cara mengatasinya
ContactSupport Buka permintaan dukungan baru di portal Azure. Di bawah Pilih jenis masalah, pilih Batas layanan dan langganan (kuota). Anda juga dapat membukanya secara terprogram menggunakan REST API Dukungan Azure.
InternalServerError Kesalahan Server Internal Coba lagi panggilan API nanti.
MissingRegistration Daftarkan penyedia sumber daya Microsoft.Quota untuk setiap langganan Anda. Untuk panduan pemecahan masalah, lihat Mengatasi kesalahan untuk pendaftaran penyedia sumber daya.
QuotaNotAvailableForResource Kuota saat ini tidak tersedia di lokasi untuk sumber daya yang diminta. Buka permintaan dukungan baru di portal Azure. Di bawah Pilih jenis masalah, pilih Batas layanan dan langganan (kuota). Anda juga dapat membukanya secara terprogram menggunakan REST API Dukungan Azure.
QuotaReductionNotSupported Batas kuota saat ini lebih tinggi dari kuota yang diminta atau penggunaan saat ini lebih tinggi dari kuota yang diminta. Mengurangi kuota tidak didukung. Kuota tidak dapat dikurangi.
RequestThrottled Setiap permintaan API tingkat langganan dan tingkat penyewa dapat dibatasi untuk membantu performa keseluruhan layanan. Jumlah permintaan melebihi tingkat permintaan API maksimum yang diizinkan. Coba lagi nanti.
ResourceNotAvailableForOffer Sumber daya saat ini tidak tersedia di lokasi untuk jenis penawaran. Untuk daftar penawaran saat ini dan yang dihentikan, lihat halaman Detail Penawaran Microsoft Azure . Untuk mengubah jenis penawaran Anda, lihat halaman Mengubah langganan Azure Anda ke penawaran lain . Anda juga dapat membuka permintaan dukungan baru di portal Azure. Di bawah Pilih jenis masalah, pilih Batas layanan dan langganan (kuota). Anda juga dapat membukanya secara terprogram menggunakan REST API Dukungan Azure.
ResourceNotAvailableForSubscription Sumber daya saat ini tidak tersedia di lokasi untuk langganan yang diminta. Buka permintaan dukungan baru di portal Azure. Di bawah Pilih jenis masalah, pilih Batas layanan dan langganan (kuota). Anda juga dapat membukanya secara terprogram menggunakan REST API Dukungan Azure.
UnableToIncreaseQuota Tidak dapat menambah kuota untuk langganan yang diminta. Buka permintaan dukungan baru di portal Azure. Di bawah Pilih jenis masalah, pilih Batas layanan dan langganan (kuota).
MFA diperlukan Permintaan kuota memerlukan Autentikasi Multifaktor. Harap aktifkan Autentikasi Multifaktor untuk penyewa/akun Anda dengan mengikuti instruksi di mengaktifkan MFA dan coba lagi
RequestPartiallyFulfilled Permintaan kuota terpenuhi sebagian. Untuk pertanyaan apa pun, buka permintaan dukungan baru di portal Azure. Di bawah Pilih jenis masalah, pilih Batas layanan dan langganan (kuota)

Dukungan dalam bahasa dan antarmuka lain

Rest API Kuota tersedia dalam Microsoft Azure SDK khusus bahasa berikut:

Menggunakan api portal Azure dan Dukungan untuk mengelola kuota

Azure memungkinkan Anda membuat dan mengelola permintaan dukungan, juga dikenal sebagai tiket dukungan. Anda dapat: