Aracılığıyla paylaş

Azure Kota Hizmeti API'si

  • Makale

Azure Kota Hizmeti REST API'si, Azure kaynak sağlayıcıları için kotaları görüntülemek ve yönetmek için tasarlanmıştır.

Önemli

Azure Kota Hizmeti API'si Genel Önizlemedir

Yeni bir Azure Kota API'si sürümü genel önizlemedir. Bu API Microsoft.Quota Kaynak Sağlayıcısını kullanır, Azure sanal makinelerini (çekirdekler/vCPU), Azure Machine Learning 'i (ayrılmış/vCPU'lar), Ağ İletişimi, Azure HPC Önbelleği, Depolama ve Azure Purview hizmetlerini destekler.

Kota, Azure aboneliğinizdeki bir kaynakta ayarlanan hizmet sınırı veya izindir. Her Azure hizmeti kotalarını tanımlar ve varsayılan değerlerini belirler. En yaygın Microsoft Azure kotaları hakkında daha fazla bilgi için bkz. Azure aboneliği ve hizmet sınırları, kotalar ve kısıtlamalar.

Kota API'lerini kullanma

Kota API'siyle şunları yapabilirsiniz:

  1. Bir kaynağın geçerli kotalarını ve kullanımlarını alın.
  2. Tüm kaynakların geçerli kotalarının ve kullanımlarının listesini alın.
  3. Kaynağın kotalarını oluşturun veya güncelleştirin.
  4. Bir kaynak için kota isteklerinin durumunu alın.
  5. Bir kaynağın bir yıllık tüm kota isteklerinin listesini alma

Kota API'si PUT çağrısı ve kapsamı

Kota API'sinin PUT isteği, kota artışı isteyen kaynak sağlayıcılarının gereksinimleriyle uyumlu olacak şekilde özelleştirilebilen ve API çağrısının tekdüzen kalmasını sağlayan bir "kapsam" parametresi içerir.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Kaynak Sağlayıcısı Kapsam
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}

Not: İşlem için PUT çağrısı örneği burada bulunabilir.

Önkoşullar

Önemli

Kota API'sini kullanabilmeniz için önce şunları kullanmanız gerekir:

Microsoft Kotası kaynak sağlayıcısını kaydetme

Microsoft Kotası kaynak sağlayıcısını kaydetmek için aşağıdaki PowerShell komutunu kullanın:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Aşağıdaki çıkışa benzer sonuçlar döndürür:

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

Microsoft.Quota kaynak sağlayıcısı kaydedildikten sonra olarak RegistrationState ayarlanır Registered. Azure kaynak sağlayıcılarını yönetme hakkında daha fazla bilgi için bkz. Azure kaynak sağlayıcıları.

Azaltma

Çok fazla API isteği gönderirseniz her abonelik düzeyi ve kiracı düzeyinde API çağrıları kısıtlanabilir. API çağrınız kısıtlanırsa sunucunun API isteğini reddettiğini belirten bir hata iletisi alırsınız. Bir süre geçtikten sonra API çağrısını yeniden deneyebilirsiniz.

API azaltma, azaltma sorunlarını giderme ve azaltmayı önleme hakkında ayrıntılı bilgi için bkz. Azure'da azaltma hatalarını giderme.

Kota İsteği İşleci Rolü

Kota İsteği İşleci, kota işlemleri için özelleştirilmiş bir Azure yerleşik rolüdür. Kota isteklerini okuma ve oluşturma, kota isteği durumunu alma ve destek biletleri oluşturma izinleri verir. Bu rolü kota işlemleri gerçekleştiren kullanıcılara, gruplara, hizmet sorumlularına, yönetilen kimliklere ve uygulamalara atayın. Başvuru için Kota İsteği İşleci rol kimliği 0e5f05e5-9ab9-446b-b98d-1e2157c94125'tir.

Kota İsteği İşleci rolü, Kota Kaynak Sağlayıcısı İzinlerini içerecek şekilde genişletilmiştir.

Kota API'leri için en iyi yöntemler

  1. İzleme kotası kullanımı: Kota kullanımınızı etkili bir şekilde izlemek için Azure kota API'sini kullanın. Bu API, geçerli kullanımınız ve belirli bir abonelik, VM ailesi ve bölge birleşimi için kullanılabilir kota hakkında gerçek zamanlı bilgiler sağlar. Kota artışı göz önünde bulundurulmadan önce kota kullanımınızı düzenli olarak kontrol etmek çok önemlidir.

  2. Kota artışı isteniyor: Kota kullanımınız önceden tanımlanmış hedefi aşarsa, kullanımınızı hedeflerinize uygun olarak geri getirmek için Azure kota API'sini kullanarak bir kota artırma isteği başlatın. İşlem basittir; istenen kota artışını özetleyen bir API isteği göndermeniz yeterlidir. Örneğin, Kuzey Avrupa'daki Dv2 VM ailesi kotası için hedef kullanım "abonelik1" altında %80 olarak ayarlandıysa ve Azure kota API'si izlemeniz gerçek %85 kullanımını gösteriyorsa, %10 ile %20 arasında bir kota artışı gönderin.

İpucu

Kaynak kullanımındaki beklenmeyen ani artışlar için yeniden bölgesel bir arabellek sağladığından ve bir artış sonrasında yeni kota sınırınıza hemen ulaşmadığınızdan emin olduğundan kaynak yükseltmesinin %10 ile %20'sine kadar bir kota artışı istemeniz önerilir. Bu yaklaşım, ek kota istemek için sık sık API çağrıları gereksinimini en aza indirerek onay şansınızı artırır.

  1. Kota artışı respnose: Kota artışı isteği gönderdikten sonra isteğinizin onaylandığını veya reddedildiğini belirten bir yanıt alırsınız. Reddetme durumunda, Azure Desteği REST API'sini kullanarak bir destek isteğini günlüğe kaydedebilir veya reddedilen kota artışı isteğinin ayrıntıları ve sorgunuzun nedeni de dahil olmak üzere Azure portal yeni destek isteği kullanarak bir izleme başlatabilirsiniz.

Kota API'si hatalarını giderme

Kota API'sini kullanırken alabileceğiniz hataları gidermek için aşağıdaki tabloları kullanın.

Hata kodu Nasıl çözülecek
ContactSupport Azure portal yeni bir destek isteği açın. Sorun türü seçin'in altında Hizmet ve abonelik sınırları (kotalar) seçeneğini belirleyin. Azure Desteği REST API'sini kullanarak program aracılığıyla da açabilirsiniz.
InternalServerError İç sunucu hatası. API çağrısını daha sonra yeniden deneyin.
MissingRegistration Aboneliklerinizin her biri için Microsoft.Quota kaynak sağlayıcısını kaydedin. Sorun giderme kılavuzu için bkz. Kaynak sağlayıcısı kaydı hatalarını çözme.
QuotaNotAvailableForResource İstenen kaynağın konumunda kota şu anda kullanılamıyor. Azure portal yeni bir destek isteği açın. Sorun türü seçin'in altında Hizmet ve abonelik sınırları (kotalar) seçeneğini belirleyin. Azure Desteği REST API'sini kullanarak program aracılığıyla da açabilirsiniz.
QuotaReductionNotSupported Geçerli kota sınırı istenen kotadan yüksek veya geçerli kullanım istenen kotadan yüksek. Kotaların azaltılması desteklenmez. Kota azaltılamaz.
RequestThrottled Hizmetin genel performansına yardımcı olmak için abonelik düzeyindeki ve kiracı düzeyindeki her API isteği kısıtlanabilir. İstek sayısı izin verilen en yüksek API istek oranını aştı. Daha sonra tekrar deneyin.
ResourceNotAvailableForOffer Kaynak şu anda teklif türü için konumunda kullanılamıyor. Geçerli ve kullanımdan kaldırılacak tekliflerin listesi için Bkz. Microsoft Azure Teklif Ayrıntıları sayfası. Teklif türünüzü değiştirmek için Azure aboneliğinizi farklı bir teklifle değiştirme sayfasına bakın. ayrıca Azure portal yeni bir destek isteği açabilirsiniz. Sorun türü seçin'in altında Hizmet ve abonelik sınırları (kotalar) seçeneğini belirleyin. Azure Desteği REST API'sini kullanarak program aracılığıyla da açabilirsiniz.
ResourceNotAvailableForSubscription Kaynak şu anda istenen aboneliğin konumunda kullanılamıyor. Azure portal yeni bir destek isteği açın. Sorun türü seçin'in altında Hizmet ve abonelik sınırları (kotalar) seçeneğini belirleyin. Azure Desteği REST API'sini kullanarak program aracılığıyla da açabilirsiniz.
UnableToIncreaseQuota İstenen abonelikler için kotalar artırılamıyor. Azure portal yeni bir destek isteği açın. Sorun türü seçin'in altında Hizmet ve abonelik sınırları (kotalar) seçeneğini belirleyin.
MFA gerekli Kota istekleri için Multi-Factor Authentication gerekir. Lütfen MFA'yı etkinleştirme yönergelerini izleyerek kiracınız/hesabınız için Multi-Factor Authentication'ı etkinleştirin ve yeniden deneyin
RequestPartiallyFulfilled Kota isteği kısmen yerine getirildi. Sorularınız için Azure portal yeni bir destek isteği açın. Sorun türü seçin'in altında Hizmet ve abonelik sınırları (kotalar) seçeneğini belirleyin

Diğer dillerde ve arabirimlerde destek

Kota REST API'sini aşağıdaki dile özgü Microsoft Azure SDK'larında kullanabilirsiniz:

Kotaları yönetmek için Azure portal ve Destek API'sini kullanma

Azure, destek bileti olarak da bilinen destek istekleri oluşturmanıza ve yönetmenize olanak tanır. Şunları yapabilirsiniz: