Azure Kota Hizmeti API'si
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:
- Bir kaynağın geçerli kotalarını ve kullanımlarını alın.
- Tüm kaynakların geçerli kotalarının ve kullanımlarının listesini alın.
- Kaynağın kotalarını oluşturun veya güncelleştirin.
- Bir kaynak için kota isteklerinin durumunu alın.
- 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:
- PowerShell kullanarak tüm abonelikleriniz için Microsoft.Quota kaynak sağlayıcısını kaydedin.
- Kota işlemlerini gerçekleştirecek tüm kullanıcı hesaplarına ve uygulamalara Kota İsteği İşleci rolünü atayın.
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
İ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.
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.
- 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:
- .NET için Microsoft Azure SDK: NuGet paketi
- Java için Microsoft Azure SDK: Java paketi
- Python için Microsoft Azure SDK: Py paketi
- JavaScript için Microsoft Azure SDK (NodeJS & Browser): JavaScript paketi
- Go için Microsoft Azure SDK: Go paketi
- Microsoft Azure CLI uzantıları: Cli paketi
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: