Sdílet prostřednictvím

Rozhraní API služby kvót Azure

  • Článek

Rozhraní REST API služby Azure Quota Service je navržené pro zobrazení a správu kvót pro poskytovatele prostředků Azure.

Důležité

Rozhraní API služby kvót Azure je ve verzi Public Preview

Nová verze rozhraní API pro kvóty Azure je ve verzi Public Preview. Toto rozhraní API využívá poskytovatele prostředků Microsoft.Quota, podporuje virtuální počítače Azure (jádra/vCPU), Azure Machine Learning (vyhrazené/vCPU), sítě, Azure HPC Cache, Storage a služby Azure Purview.

Kvóta je limit služby nebo povolení nastavené pro prostředek ve vašem předplatném Azure. Každá služba Azure definuje své kvóty a určuje své výchozí hodnoty. Další informace o nejběžnějších kvótách Microsoft Azure najdete v tématu Limity, kvóty a omezení předplatného a služeb Azure.

Použití rozhraní API pro kvóty

S rozhraním API pro kvóty můžete:

  1. Získejte aktuální kvóty a využití prostředku.
  2. Získejte seznam aktuálních kvót a využití všech prostředků.
  3. Vytvoření nebo aktualizace kvót prostředku
  4. Získání stavu žádostí o kvótu pro prostředek
  5. Získání seznamu všech žádostí o kvótu prostředku na jeden rok

Volání a rozsah PUT rozhraní API pro kvóty

Požadavek PUT rozhraní API pro kvóty obsahuje parametr scope, který je možné přizpůsobit tak, aby odpovídal požadavkům poskytovatelů prostředků, kteří chtějí navýšit kvótu, a zajistil tak, že volání rozhraní API zůstane jednotné.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Poskytovatel prostředků Obor
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}

Poznámka: Příklad volání PUT pro výpočetní prostředky najdete tady.

Požadavky

Důležité

Abyste mohli rozhraní API pro kvóty použít, musíte:

Registrace poskytovatele prostředků kvót Microsoftu

Pokud chcete zaregistrovat poskytovatele prostředků kvót Microsoftu, použijte následující příkaz PowerShellu:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Vrátí výsledky podobné následujícímu výstupu:

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

Jakmile se poskytovatel prostředků Microsoft.Quota zaregistruje RegistrationState , nastaví se na Registered. Další informace o správě poskytovatelů prostředků Azure najdete v tématu Poskytovatelé prostředků Azure.

Throttling

Všechna volání rozhraní API na úrovni předplatného a tenanta mohou být omezena, pokud odesíláte příliš mnoho požadavků rozhraní API. Pokud je vaše volání rozhraní API omezené, zobrazí se chybová zpráva s oznámením, že server zamítl požadavek rozhraní API. Po uplynutí určité doby můžete zkusit znovu volání rozhraní API.

Podrobnosti o omezování rozhraní API, řešení potíží s omezováním a o tom, jak se vyhnout omezování, najdete v tématu Řešení potíží s chybami omezování v Azure.

Role operátora žádosti o kvótu

Operátor žádosti o kvótu je předdefinovaná role Azure přizpůsobená pro operace kvót. Uděluje oprávnění ke čtení a vytváření žádostí o kvótu, získání stavu žádosti o kvótu a vytváření lístků podpory. Tuto roli přiřaďte uživatelům, skupinám, instančním objektům, spravovaným identitám a aplikacím, které dělají operace kvót. Pro referenci je ID role operátora žádosti o kvótu 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Role Operátor žádosti o kvótu je rozšířená tak, aby zahrnovala oprávnění poskytovatele prostředků kvót.

Osvědčené postupy pro rozhraní API pro kvóty

  1. Monitorování využití kvót: Využijte rozhraní API pro kvóty Azure k efektivnímu sledování využití kvóty. Toto rozhraní API poskytuje informace o aktuálním využití a dostupné kvótě v reálném čase pro konkrétní kombinaci předplatného, řady virtuálních počítačů a oblasti. Před zvážením navýšení kvóty je důležité pravidelně kontrolovat využití kvóty.

  2. Žádost o navýšení kvóty: Pokud využití kvóty překročí předdefinovaný cíl, vytvořte žádost o navýšení kvóty pomocí rozhraní API pro kvóty Azure, aby se využití vrátilo do souladu s vašimi cíli. Proces je jednoduchý – jednoduše odešlete požadavek rozhraní API, který popisuje požadované navýšení kvóty. Pokud je například cílové využití kvóty pro řadu virtuálních počítačů Dv2 v oblasti Evropa – sever v části "předplatné1" nastavené na 80 % a monitorování rozhraní API pro kvóty Azure značí skutečné využití 85 %, odešlete navýšení kvóty o 10 % na 20 %.

Tip

Doporučujeme požádat o navýšení kvóty o 10 až 20 % utlizace prostředků, protože poskytuje rezonalable vyrovnávací paměť pro neočekávané špičky ve využití prostředků, čímž zajistíte, že po zvýšení nedojde k okamžitému dosažení nového limitu kvóty. Tento přístup minimalizuje potřebu častých volání rozhraní API pro vyžádání další kvóty a zvyšuje tak šanci na schválení.

  1. Respnose navýšení kvóty: Po odeslání žádosti o navýšení kvóty obdržíte odpověď s informací, jestli byla vaše žádost schválena nebo zamítnuta. V případě zamítnutí můžete zahájit následné zpracování tím, že žádost o podporu zapíšete pomocí rozhraní REST API podpory Azure nebo použijete novou žádost o podporu v Azure Portal, včetně konkrétních požadavků na zamítnutí kvóty a důvodu vašeho dotazu.

Řešení chyb rozhraní API pro kvóty

Při řešení chyb, ke které může dojít při používání rozhraní API pro kvóty, použijte následující tabulky.

Kód chyby Jak to vyřešit
Podpora kontaktu Otevřete novou žádost o podporu v Azure Portal. V části Vyberte typ problému zvolte Limity služeb a předplatných (kvóty). Můžete ho také otevřít programově pomocí rozhraní REST API podpory Azure.
InternalServerError Vnitřní chyba serveru. Zkuste rozhraní API volat znovu později.
Chybějícíregistrace Zaregistrujte poskytovatele prostředků Microsoft.Quota pro každé z vašich předplatných. Pokyny k řešení potíží najdete v tématu Řešení chyb při registraci poskytovatele prostředků.
QuotaNotAvailableForResource Kvóta není v umístění požadovaného prostředku momentálně k dispozici. Otevřete novou žádost o podporu v Azure Portal. V části Vyberte typ problému zvolte Limity služeb a předplatných (kvóty). Můžete ho také otevřít programově pomocí rozhraní REST API podpory Azure.
QuotaReductionNotSupported Aktuální maximální kvóta je vyšší než požadovaná kvóta nebo aktuální využití je vyšší než požadovaná kvóta. Snížení kvót se nepodporuje. Kvótu nelze snížit.
PožadavekThrottled Všechny požadavky rozhraní API na úrovni předplatného a tenanta se můžou omezovat, aby se pomohlo s celkovým výkonem služby. Počet požadavků překročil maximální povolenou rychlost požadavků rozhraní API. Zkuste to později.
ResourceNotAvailableForOffer Prostředek je momentálně nedostupný v umístění pro typ nabídky. Seznam aktuálních a vyřazených nabídek najdete na stránce s podrobnostmi o nabídkách Microsoft Azure . Pokud chcete změnit typ nabídky, podívejte se na stránku Změna předplatného Azure na jinou nabídku . Můžete také otevřít novou žádost o podporu v Azure Portal. V části Vyberte typ problému zvolte Limity služeb a předplatných (kvóty). Můžete ho také otevřít programově pomocí rozhraní REST API podpory Azure.
ResourceNotAvailableForSubscription Prostředek je momentálně nedostupný v umístění požadovaného předplatného. Otevřete novou žádost o podporu v Azure Portal. V části Vyberte typ problému zvolte Limity služeb a předplatných (kvóty). Můžete ho také otevřít programově pomocí rozhraní REST API podpory Azure.
Nelze vytvořitQuota Nelze zvýšit kvóty pro požadovaná předplatná. Otevřete novou žádost o podporu v Azure Portal. V části Vyberte typ problému zvolte Limity služeb a předplatných (kvóty).
Vyžaduje se vícefaktorové ověřování Žádosti o kvótu vyžadují vícefaktorové ověřování. Povolte pro svého tenanta nebo účet vícefaktorové ověřování podle pokynů v tématu povolení vícefaktorového ověřování a zkuste to znovu.
Vyplněná část žádosti Žádost o kvótu je částečně splněná. V případě jakýchkoli dotazů otevřete novou žádost o podporu v Azure Portal. V části Vyberte typ problému zvolte Limity služeb a předplatných (kvóty).

Podpora v dalších jazycích a rozhraních

Rozhraní REST API pro kvóty je k dispozici v následujících sadách Microsoft Azure SDK pro konkrétní jazyk:

Správa kvót pomocí rozhraní API Azure Portal a podpory

Azure umožňuje vytvářet a spravovat žádosti o podporu, označované také jako lístky podpory. Můžete: