Bagikan melalui

Api Kuota Azure

  • Artikel

API Kuota adalah REST API yang dapat Anda gunakan untuk melihat dan mengelola kuota untuk layanan Azure.

Penting

Ketersediaan umum API Kuota

Azure Quota API sekarang tersedia secara umum. Saat ini mendukung komputer virtual Azure (core/vCPU) dan layanan Azure Machine Learning (dedicated/vCPU).

Catatan: Versi baru Rest API Kuota ada di pratinjau publik, di Azure Quota Service Rest API. Ini menggunakan penyedia sumber daya Microsoft.Quota dan mendukung komputer virtual Azure (core/vCPU), Azure Machine Learning, jaringan Azure, azure HPC Cache dan layanan Azure Purview.

Kuota adalah nilai maksimum untuk sumber daya, tindakan, dan item dalam langganan Azure Anda. Setiap layanan Azure menentukan kuotanya dan menentukan nilai defaultnya. Bergantung pada kebutuhan bisnis Anda, Anda mungkin perlu meningkatkan nilai kuota Anda.

Untuk informasi selengkapnya tentang batas Microsoft Azure yang paling umum, lihat Batas, kuota, dan batasan langganan dan layanan Azure.

Menggunakan API Kuota

Dengan API Kuota, Anda dapat:

  • Dapatkan kuota dan penggunaan sumber daya saat ini.
  • Dapatkan daftar kuota dan penggunaan semua sumber daya saat ini.
  • Membuat atau memperbarui kuota sumber daya.
  • Dapatkan status permintaan kuota untuk sumber daya.
  • Dapatkan daftar semua permintaan kuota sumber daya selama satu tahun.

Operasi REST

Azure Quota API memudahkan untuk mencari kuota Anda dan meminta peningkatan menggunakan operasi REST ini:

Prasyarat

Penting

Sebelum dapat menggunakan Api Kuota, Anda harus:

Mendaftarkan penyedia sumber daya Kapasitas Microsoft

Untuk mendaftarkan penyedia sumber daya Kapasitas Microsoft, gunakan perintah PowerShell ini:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Ini mengembalikan hasil yang mirip dengan output ini:

ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes     : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations         : {West Europe, East US, South Central US...}

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

Peran Operator Permintaan Kuota

Peran 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.

Kuota vCPU

Anda dapat menggunakan Api Kuota untuk mengelola kuota untuk dua jenis kuota vCPU ini:

  • Kuota vCPU standar untuk VM prabayar dan instans VM yang dipesan .
  • Kuota Spot vCPU untuk Spot VM.

Untuk mempelajari selengkapnya tentang batas dan kuota Azure, lihat Batas, kuota, dan batasan langganan dan layanan Azure.

Kuota Azure Machine Learning

Anda dapat menggunakan API Kuota untuk mengelola kuota untuk ruang kerja dan komputasi Azure Machine Learning. Baca artikel Mengelola dan meningkatkan kuota untuk sumber daya dengan Azure Machine Learning untuk mempelajari tentang:

  • Batas default pada sumber daya Azure yang terkait dengan Azure Machine Learning.
  • Membuat kuota tingkat ruang kerja.
  • Melihat kuota dan batasan Anda.
  • Meminta penambahan kuota.
  • Titik akhir kuota dan DNS privat.

Wilayah

Sebagian besar kuota khusus untuk beban kerja di satu wilayah mana pun. Minta kuota terpisah untuk setiap wilayah tempat Anda ingin menyebarkan layanan. Untuk mencantumkan semua wilayah Azure tempat layanan ada, gunakan operasi Daftar Menurut Wilayah Layanan .

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.

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.Capacity 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 sudah dihentikan, lihat halaman Detail Penawaran Microsoft Azure . Untuk mengubah jenis penawaran Anda, lihat halaman Ubah 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).

Dukungan dalam bahasa dan antarmuka lain

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

  • Microsoft Azure SDK untuk .NET: Paket NuGet
  • Microsoft Azure SDK untuk Python: Paket Py
  • Microsoft Azure SDK untuk JavaScript (NodeJS & Browser): paket js
  • Microsoft Azure SDK for Go: Paket Go

Menggunakan api portal Azure dan Dukungan untuk mengelola kuota

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