Azure-Kontingent-API
Die Kontingent-API ist eine REST-API, mit der Sie Kontingente für Azure-Dienste anzeigen und verwalten können.
Wichtig
Allgemeine Verfügbarkeit der Kontingent-API
Die Azure-Kontingent-API ist jetzt allgemein verfügbar. Derzeit werden Virtuelle Azure-Computer (Kerne/vCPU) und Azure Machine Learning-Dienste (dedicated/vCPUs) unterstützt.
Hinweis: Eine neue Version der Kontingent-REST-API befindet sich in der öffentlichen Vorschau unter Azure Quota Service Rest API. Es verwendet den Microsoft.Quota-Ressourcenanbieter und unterstützt Azure-VMs (Kerne/vCPU), Azure Machine Learning, Azure-Netzwerke, Azure HPC Cache und Azure Purview-Dienste.
Kontingente sind die Maximalwerte für Ressourcen, Aktionen und Elemente in Ihrem Azure-Abonnement. Jeder Azure-Dienst definiert seine Kontingente und bestimmt seine Standardwerte. Abhängig von Ihren geschäftlichen Anforderungen müssen Sie möglicherweise Ihre Kontingentwerte erhöhen.
Weitere Informationen zu den gängigsten Microsoft Azure-Grenzwerten finden Sie unter Grenzwerte für Azure-Abonnements und -Dienste, Kontingente und Einschränkungen.
Verwenden der Kontingent-API
Mit der Kontingent-API können Sie:
- Rufen Sie die aktuellen Kontingente und Nutzungen einer Ressource ab.
- Rufen Sie eine Liste der aktuellen Kontingente und Nutzungen aller Ressourcen ab.
- Erstellen oder Aktualisieren von Kontingenten einer Ressource
- Rufen Sie die status von Kontingentanforderungen für eine Ressource ab.
- Rufen Sie die Liste aller Kontingentanforderungen einer Ressource für ein Jahr ab.
REST-Vorgänge
Die Azure-Kontingent-API vereinfacht die Suche nach Kontingenten und Anforderungserhöhungen mithilfe der folgenden REST-Vorgänge:
- Details zu REST-Vorgängen für die Kontingentverwaltung finden Sie unter Referenz zur Kontingent-API.
- Details zur Kontingentanforderung status REST-Vorgängen finden Sie unter Kontingentanforderung status API-Referenz.
Voraussetzungen
Wichtig
Bevor Sie die Kontingent-API verwenden können, müssen Sie Folgendes ausführen:
- Registrieren Sie den Microsoft Capacity -Ressourcenanbieter (Microsoft.Capacity) für alle Ihre Abonnements mithilfe von PowerShell.
- Weisen Sie die Rolle Kontingentanforderungsoperator allen Benutzerkonten und Anwendungen zu, die Kontingentvorgänge ausführen.
Registrieren des Microsoft Capacity-Ressourcenanbieters
Verwenden Sie den folgenden PowerShell-Befehl, um den Microsoft Capacity-Ressourcenanbieter zu registrieren:
Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity
Es werden Ergebnisse zurückgegeben, die der folgenden Ausgabe ähneln:
ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations : {West Europe, East US, South Central US...}
Sobald der Microsoft.Capacity-Ressourcenanbieter registriert wurde, wird auf RegistrationState
festgelegt Registered
. Weitere Informationen zum Verwalten von Azure-Ressourcenanbietern finden Sie unter Azure-Ressourcenanbieter.
Rolle "Kontingentanforderungsoperator"
Die Rolle Kontingentanforderungsoperator ist eine integrierte Azure-Rolle, die für Kontingentvorgänge angepasst wurde. Sie gewährt Berechtigungen zum Lesen und Erstellen von Kontingentanforderungen, zum Abrufen von Kontingentanforderungen status und zum Erstellen von Supporttickets. Weisen Sie diese Rolle Benutzern, Gruppen, Dienstprinzipalen, verwalteten Identitäten und Anwendungen zu, die Kontingentvorgänge ausführen. Als Referenz lautet die Rollen-ID des Kontingentanforderungsoperators 0e5f05e5-9ab9-446b-b98d-1e2157c94125.
vCPU-Kontingente
Sie können die Kontingent-API verwenden, um Kontingente für diese beiden Arten von vCPU-Kontingenten zu verwalten:
- Standard-vCPU-Kontingent für VMs mit nutzungsbasierter Bezahlung und reservierte VM-Instanzen.
- VCPU-Kontingent für Spot-VMs ermitteln.
Weitere Informationen zu Azure-Grenzwerten und -Kontingenten finden Sie unter Grenzwerte für Azure-Abonnements und -Dienste, Kontingente und Einschränkungen.
Azure Machine Learning-Kontingente
Sie können die Kontingent-API verwenden, um Kontingente für Azure Machine Learning-Arbeitsbereiche und Computevorgänge zu verwalten. Weitere Informationen finden Sie im Artikel Verwalten und Erhöhen von Kontingenten für Ressourcen mit Azure Machine Learning :
- Standardgrenzwerte für Azure-Ressourcen in Bezug auf Azure Machine Learning
- Erstellen von Kontingenten auf Arbeitsbereichsebene
- Anzeigen Ihrer Kontingente und Grenzwerte
- Anfordern von Kontingenterhöhungen
- Privater Endpunkt und DNS-Kontingente
Regions
Die meisten Kontingente sind spezifisch für eine Workload in einer beliebigen Region. Fordern Sie separate Kontingente für jede Region an, in der Sie einen Dienst bereitstellen möchten. Verwenden Sie den Vorgang Nach Dienstregionen auflisten , um alle Azure-Regionen aufzulisten, in denen sich der Dienst befindet.
Drosselung
Alle API-Aufrufe auf Abonnement- und Mandantenebene können gedrosselt werden, wenn Sie zu viele API-Anforderungen senden. Wenn Ihr API-Aufruf gedrosselt wird, erhalten Sie eine Fehlermeldung, die besagt, dass der Server die API-Anforderung abgelehnt hat. Sie können den API-Aufruf nach einiger Zeit wiederholen.
Ausführliche Informationen zur API-Einschränkung, zur Problembehandlung bei Drosselungsproblemen und zur Vermeidung einer Drosselung finden Sie unter Problembehandlung bei Drosselungsfehlern in Azure.
Problembehandlung bei Kontingent-API-Fehlern
Verwenden Sie die folgenden Tabellen, um Fehler zu beheben, die bei der Verwendung der Kontingent-API auftreten können.
Fehlercode | Wie sie gelöst werden kann |
---|---|
ContactSupport | Öffnen Sie eine neue Supportanfrage im Azure-Portal. Wählen Sie unter Problemtyp auswählendie Option Dienst- und Abonnementlimits (Kontingente) aus. Sie können es auch programmgesteuert mit der Azure-Support-REST-API öffnen. |
InternalServerError | Interner Serverfehler. Wiederholen Sie den API-Aufruf später. |
MissingRegistration | Registrieren Sie den Microsoft.Capacity-Ressourcenanbieter für jedes Ihrer Abonnements. Anleitungen zur Problembehandlung finden Sie unter Beheben von Fehlern bei der Ressourcenanbieterregistrierung. |
QuotaNotAvailableForResource | Das Kontingent ist derzeit am Speicherort für die angeforderte Ressource nicht verfügbar. Öffnen Sie eine neue Supportanfrage im Azure-Portal. Wählen Sie unter Problemtyp auswählendie Option Dienst- und Abonnementlimits (Kontingente) aus. Sie können es auch programmgesteuert mit der Azure-Support-REST-API öffnen. |
QuotaReductionNotSupported | Das aktuelle Kontingentlimit ist höher als das angeforderte Kontingent, oder die aktuelle Nutzung ist höher als das angeforderte Kontingent. Das Reduzieren von Kontingenten wird nicht unterstützt. Das Kontingent kann nicht reduziert werden. |
RequestThrottled | Alle API-Anforderungen auf Abonnement- und Mandantenebene können gedrosselt werden, um die Gesamtleistung des Diensts zu verbessern. Die Anzahl der Anforderungen überstieg die maximal zulässige API-Anforderungsrate. Versuchen Sie es später noch einmal. |
ResourceNotAvailableForOffer | Die Ressource ist derzeit am Speicherort für den Angebotstyp nicht verfügbar. Die Liste der aktuellen und eingestellten Angebote finden Sie auf der Seite Mit den Details zum Microsoft Azure-Angebot . Informationen zum Ändern Ihres Angebotstyps finden Sie unter Ändern Ihres Azure-Abonnements in ein anderes Angebot . Sie können auch eine neue Supportanfrage im Azure-Portal öffnen. Wählen Sie unter Problemtyp auswählendie Option Dienst- und Abonnementlimits (Kontingente) aus. Sie können es auch programmgesteuert mit der Azure-Support-REST-API öffnen. |
ResourceNotAvailableForSubscription | Die Ressource ist derzeit am Speicherort für das angeforderte Abonnement nicht verfügbar. Öffnen Sie eine neue Supportanfrage im Azure-Portal. Wählen Sie unter Problemtyp auswählendie Option Dienst- und Abonnementlimits (Kontingente) aus. Sie können es auch programmgesteuert mit der Azure-Support-REST-API öffnen. |
UnableToIncreaseQuota | Kontingente für die angeforderten Abonnements können nicht erhöht werden. Öffnen Sie eine neue Supportanfrage im Azure-Portal. Wählen Sie unter Problemtyp auswählendie Option Dienst- und Abonnementlimits (Kontingente) aus. |
Support für andere Sprachen und Schnittstellen
Die Kontingent-REST-API ist in den folgenden sprachspezifischen Microsoft Azure SDKs verfügbar:
- Microsoft Azure SDK für .NET: NuGet-Paket
- Microsoft Azure SDK für Python: Py-Paket
- Microsoft Azure SDK für JavaScript (NodeJS & Browser): js-Paket
- Microsoft Azure SDK for Go: Go-Paket
Verwenden der Azure-Portal- und Support-API zum Verwalten von Kontingenten
Azure ermöglicht das Erstellen und Verwalten von Supportanfragen (auch Supporttickets genannt). Ihre Möglichkeiten: