Rozhraní API pro kvóty Azure
Rozhraní API pro kvóty je rozhraní REST API, které můžete použít k zobrazení a správě kvót pro služby Azure.
Důležité
Obecná dostupnost rozhraní API pro kvóty
Rozhraní API pro kvóty Azure je teď obecně dostupné. V současné době podporuje virtuální počítače Azure (jádra/vCPU) a služby Azure Machine Learning (vyhrazené/vCPU).
Poznámka: Nová verze rozhraní REST API pro kvóty je ve verzi Public Preview v rozhraní Rest API služby Azure Quota Service. Používá poskytovatele prostředků Microsoft.Quota a podporuje virtuální počítače Azure (jádra/vCPU), Azure Machine Learning, sítě Azure, Azure HPC Cache a služby Azure Purview.
Kvóty jsou maximální hodnoty pro prostředky, akce a položky ve vašem předplatném Azure. Každá služba Azure definuje své kvóty a určuje své výchozí hodnoty. V závislosti na vašich obchodních potřebách může být potřeba zvýšit hodnoty kvót.
Další informace o nejběžnějších limitech 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
Pomocí rozhraní API pro kvóty můžete:
- Získejte aktuální kvóty a využití prostředku.
- Získejte seznam aktuálních kvót a využití všech prostředků.
- Vytvoření nebo aktualizace kvót prostředku
- Získejte stav žádostí o kvótu pro prostředek.
- Získejte seznam všech žádostí o kvótu prostředku na jeden rok.
Operace REST
Rozhraní API pro kvóty Azure usnadňuje vyhledání kvót a zvýšení požadavků pomocí těchto operací REST:
- Podrobnosti o operacích REST správy kvót najdete v referenčních informacích k rozhraní API pro kvóty.
- Podrobnosti o operacích REST se stavem žádosti o kvótu najdete v referenčních informacích k rozhraní API pro stav požadavků na kvótu.
Požadavky
Důležité
Abyste mohli rozhraní API pro kvóty použít, musíte:
- Zaregistrujte poskytovatele prostředků Microsoft Capacity (Microsoft.Capacity) pro všechna vaše předplatná pomocí PowerShellu.
- Přiřaďte roli Operátor žádosti o kvótu všem uživatelským účtům a aplikacím, které budou provádět operace kvót.
Registrace poskytovatele prostředků Kapacity Microsoftu
Pokud chcete zaregistrovat poskytovatele prostředků Kapacity Microsoftu, použijte tento příkaz PowerShellu:
Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity
Vrátí výsledky podobné tomuto výstupu:
ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations : {West Europe, East US, South Central US...}
Jakmile se poskytovatel prostředků Microsoft.Capacity zaregistruje RegistrationState
, nastaví se na Registered
. Další informace o správě poskytovatelů prostředků Azure najdete v tématu Poskytovatelé prostředků Azure.
Role operátora žádosti o kvótu
Role 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 žádostí o kvótu a vytváření lístků podpory. Přiřaďte tuto roli 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átor žádosti o kvótu 0e5f05e5-9ab9-446b-b98d-1e2157c94125.
Kvóty virtuálních procesorů
Pomocí rozhraní API pro kvóty můžete spravovat kvóty pro tyto dva typy kvót virtuálních procesorů:
- Standardní kvóta virtuálních procesorů pro virtuální počítače s průběžnými platbami a rezervované instance virtuálních počítačů
- Kvóta spotových virtuálních procesorů pro spotové virtuální počítače.
Další informace o limitech a kvótách Azure najdete v tématu Limity, kvóty a omezení předplatného a služeb Azure.
Kvóty služby Azure Machine Learning
Rozhraní API pro kvóty můžete použít ke správě kvót pro pracovní prostory a výpočetní prostředky Služby Azure Machine Learning. Přečtěte si článek Správa a zvýšení kvót pro prostředky pomocí služby Azure Machine Learning , kde najdete následující informace:
- Výchozí omezení pro prostředky Azure související se službou Azure Machine Learning
- Vytváření kvót na úrovni pracovního prostoru
- Zobrazení kvót a limitů
- Žádost o navýšení kvóty
- Kvóty privátního koncového bodu a DNS.
Oblasti
Většina kvót je specifická pro úlohu v libovolné oblasti. Vyžádejte si samostatné kvóty pro každou oblast, ve které chcete službu nasadit. Pokud chcete zobrazit seznam všech oblastí Azure, ve kterých služba existuje, použijte operaci Vypsat podle oblastí služby .
Throttling
Všechna volání rozhraní API na úrovni předplatného a tenanta se můžou omezovat, 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 odmítl požadavek rozhraní API. Po uplynutí určité doby můžete zkusit volat rozhraní API znovu.
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.
Ř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 kontaktů | 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 později. |
MissingRegistration | Zaregistrujte poskytovatele prostředků Microsoft.Capacity 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 aktuá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í limit kvóty 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 Podrobnosti o nabídce 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 zvýšit hodnotuQuota | Nelze zvýšit kvóty požadovaných předplatných. 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:
- Microsoft Azure SDK pro .NET: Balíček NuGet
- Microsoft Azure SDK pro Python: Balíček Py
- Microsoft Azure SDK pro JavaScript (NodeJS & Browser): balíček js
- Balíček Microsoft Azure SDK for Go: Go
Použití rozhraní API Azure Portal a podpory ke správě kvót
Azure umožňuje vytvářet a spravovat žádosti o podporu, označované také jako lístky podpory. Můžete: