Aracılığıyla paylaş

Azure Kota API'si

  • Makale

Kota API'si, Azure hizmetlerinin kotalarını görüntülemek ve yönetmek için kullanabileceğiniz bir REST API'dir.

Önemli

Kota API'sinde genel kullanılabilirlik

Azure Kota API'si genel kullanıma sunuldu. Şu anda Azure sanal makinelerini (çekirdekler/vCPU) ve Azure Machine Learning hizmetlerini (ayrılmış/vCPU' lar) desteklemektedir.

Not: Kota REST API'sinin yeni bir sürümü, Azure Kota Hizmeti Rest API'sinde genel önizleme aşamasındadır. Microsoft.Quota kaynak sağlayıcısını kullanır ve Azure sanal makinelerini (çekirdekler/vCPU), Azure Machine Learning'i, Azure ağını, Azure HPC Önbelleği ve Azure Purview hizmetlerini destekler.

Kotalar, Azure aboneliğinizdeki kaynaklar, eylemler ve öğeler için en yüksek değerlerdir. Her Azure hizmeti kotalarını tanımlar ve varsayılan değerlerini belirler. İş gereksinimlerinize bağlı olarak kota değerlerinizi artırmanız gerekebilir.

En yaygın Microsoft Azure sınırları hakkında daha fazla bilgi için bkz. Azure aboneliği ve hizmet sınırları, kotalar ve kısıtlamalar.

Kota API'si 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 alın.

REST işlemleri

Azure Kota API'si, şu REST işlemlerini kullanarak kotalarınızı ve istek artışlarınızı aramanızı kolaylaştırır:

Önkoşullar

Önemli

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

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

Microsoft Capacity kaynak sağlayıcısını kaydetmek için şu PowerShell komutunu kullanın:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Bu çıkışa benzer sonuçlar döndürür:

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

Microsoft.Capacity 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ı.

Kota İsteği İşleci rolü

Kota İsteği İşleci rolü, 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.

vCPU kotaları

Bu iki tür vCPU kotasının kotalarını yönetmek için Kota API'sini kullanabilirsiniz:

  • Kullandıkça öde VM'leri ve ayrılmış VM örnekleri için standart vCPU kotası.
  • Spot VM'ler için spot vCPU kotası.

Azure sınırları ve kotaları hakkında daha fazla bilgi edinmek için bkz. Azure aboneliği ve hizmet sınırları, kotalar ve kısıtlamalar.

Azure Machine Learning kotaları

Azure Machine Learning çalışma alanları ve işlem kotalarını yönetmek için Kota API'sini kullanabilirsiniz. Aşağıdakiler hakkında bilgi edinmek için Azure Machine Learning ile kaynaklar için kotaları yönetme ve artırma makalesini okuyun:

  • Azure Machine Learning ile ilgili Azure kaynaklarında varsayılan sınırlar.
  • Çalışma alanı düzeyinde kotalar oluşturma.
  • Kotalarınızı ve sınırlarınızı görüntüleme.
  • Kota artışı isteniyor.
  • Özel uç nokta ve DNS kotaları.

Bölgeler

Kotaların çoğu herhangi bir bölgedeki iş yükü için özeldir. Bir hizmeti dağıtmak istediğiniz her bölge için ayrı kotalar isteyin. Hizmetin bulunduğu tüm Azure bölgelerini listelemek için , Hizmete Göre Bölgeleri Listele işlemini kullanın.

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

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
  • Python için Microsoft Azure SDK: Py paketi
  • JavaScript için Microsoft Azure SDK (NodeJS & Browser): js paketi
  • Go için Microsoft Azure SDK: Go 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: