Azure-Kontingent-API

  • Artikel

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:

Voraussetzungen

Wichtig

Bevor Sie die Kontingent-API verwenden können, müssen Sie Folgendes 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: