Azure Quota API

  • Article

L’API Quota est une API REST que vous pouvez utiliser pour afficher et gérer les quotas pour les services Azure.

Important

Disponibilité générale de l’API quota

L’API Quota Azure est désormais en disponibilité générale. Il prend actuellement en charge les machines virtuelles Azure (cœurs/processeurs virtuels) et les services Azure Machine Learning (dédiés/processeurs virtuels).

Note: Une nouvelle version de l’API REST de quota est en préversion publique sur l’API Rest du service De quota Azure. Il utilise le fournisseur de ressources Microsoft.Quota et prend en charge les machines virtuelles Azure (cœurs/vCPU), Azure Machine Learning, la mise en réseau Azure, azure HPC Cache et les services Azure Purview.

Les quotas sont les valeurs maximales pour les ressources, l’action et les éléments de votre abonnement Azure. Chaque service Azure définit ses quotas et détermine ses valeurs par défaut. En fonction des besoins de votre entreprise, vous devrez peut-être augmenter vos valeurs de quota.

Pour plus d’informations sur les limites microsoft Azure les plus courantes, consultez Limites, quotas et contraintes d’abonnement et de service Azure.

Utilisation de l’API Quota

Avec l’API Quota, vous pouvez :

  • Obtenez les quotas et les utilisations actuels d’une ressource.
  • Obtenez la liste des quotas actuels et des utilisations de toutes les ressources.
  • Créer ou mettre à jour des quotas d’une ressource.
  • Obtenez le status des demandes de quota pour une ressource.
  • Obtenez la liste de toutes les demandes de quota d’une ressource pendant un an.

Opérations REST

L’API Quota Azure facilite la recherche de vos quotas et des augmentations de demande à l’aide de ces opérations REST :

Prérequis

Important

Avant de pouvoir utiliser l’API Quota, vous devez :

Inscription du fournisseur de ressources Microsoft Capacity

Pour inscrire le fournisseur de ressources Microsoft Capacity, utilisez cette commande PowerShell :

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Il retourne des résultats similaires à cette sortie :

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

Une fois le fournisseur de ressources Microsoft.Capacity inscrit, le RegistrationState est défini sur Registered. Pour plus d’informations sur la gestion des fournisseurs de ressources Azure, consultez Fournisseurs de ressources Azure.

Rôle Opérateur de demande de quota

Le rôle Opérateur de demande de quota est un rôle intégré Azure personnalisé pour les opérations de quota. Il accorde des autorisations pour lire et créer des demandes de quota, obtenir des status de demande de quota et créer des tickets de support. Attribuez ce rôle aux utilisateurs, groupes, principaux de service, identités managées et applications qui effectuent des opérations de quota. Pour référence, l’ID de rôle Opérateur de demande de quota est 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Quotas de processeurs virtuels

Vous pouvez utiliser l’API Quota pour gérer les quotas pour ces deux types de quotas vCPU :

  • Quota de processeurs virtuels standard pour les machines virtuelles avec paiement à l’utilisation et les instances de machines virtuelles réservées .
  • Quota de processeurs virtuels Spot pour les machines virtuelles Spot .

Pour en savoir plus sur les limites et quotas Azure, consultez Limites, quotas et contraintes d’abonnement Et de service Azure.

Quotas Azure Machine Learning

Vous pouvez utiliser l’API Quota pour gérer les quotas pour les espaces de travail et le calcul Azure Machine Learning. Consultez l’article Gérer et augmenter les quotas pour les ressources avec Azure Machine Learning pour en savoir plus sur :

  • Limites par défaut des ressources Azure relatives à Azure Machine Learning.
  • Création de quotas au niveau de l’espace de travail.
  • Consultation de vos quotas et limites.
  • Demande d’augmentations de quota.
  • Point de terminaison privé et quotas DNS.

Régions

La plupart des quotas sont spécifiques pour une charge de travail dans une région. Demandez des quotas distincts pour chaque région où vous souhaitez déployer un service. Pour répertorier toutes les régions Azure dans lesquelles le service existe, utilisez l’opération Liste par régions de service .

Limitation

Chaque appel d’API au niveau de l’abonnement et au niveau du locataire peut être limité si vous envoyez trop de demandes d’API. Si votre appel d’API est limité, vous recevez un message d’erreur indiquant que le serveur a rejeté la demande d’API. Vous pouvez réessayer l’appel d’API après un certain temps.

Pour plus d’informations sur la limitation des API, sur la résolution des problèmes de limitation et sur la façon d’éviter d’être limité, consultez Résolution des erreurs de limitation dans Azure.

Résolution des erreurs d’API quota

Utilisez les tableaux suivants pour résoudre les erreurs que vous pouvez obtenir lors de l’utilisation de l’API Quota.

Code d’erreur Comment le résoudre
ContactSupport Ouvrez une nouvelle demande de support dans le Portail Azure. Sous Sélectionner un type de problème, choisissez Limites de service et d’abonnement (quotas). Vous pouvez également l’ouvrir par programmation à l’aide de l’API REST de prise en charge Azure.
InternalServerError Erreur interne du serveur. Réessayez l’appel d’API ultérieurement.
MissingRegistration Inscrivez le fournisseur de ressources Microsoft.Capacity pour chacun de vos abonnements. Pour obtenir des conseils de dépannage, consultez Résoudre les erreurs d’inscription du fournisseur de ressources.
QuotaNotAvailableForResource Le quota n’est actuellement pas disponible à l’emplacement de la ressource demandée. Ouvrez une nouvelle demande de support dans le Portail Azure. Sous Sélectionner un type de problème, choisissez Limites de service et d’abonnement (quotas). Vous pouvez également l’ouvrir par programmation à l’aide de l’API REST de prise en charge Azure.
QuotaReductionNotSupported La limite de quota actuelle est supérieure au quota demandé ou l’utilisation actuelle est supérieure au quota demandé. La réduction des quotas n’est pas prise en charge. Le quota ne peut pas être réduit.
RequestThrottled Toutes les demandes d’API au niveau de l’abonnement et au niveau du locataire peuvent être limitées pour faciliter les performances globales du service. Le nombre de requêtes a dépassé le taux maximal autorisé de demandes d’API. Réessayez plus tard.
ResourceNotAvailableForOffer La ressource n’est actuellement pas disponible à l’emplacement du type d’offre. Pour obtenir la liste des offres actuelles et supprimées, consultez la page Détails de l’offre Microsoft Azure . Pour modifier votre type d’offre, consultez la page Modifier votre abonnement Azure en une autre offre . Vous pouvez également ouvrir une nouvelle demande de support dans le Portail Azure. Sous Sélectionner un type de problème, choisissez Limites de service et d’abonnement (quotas). Vous pouvez également l’ouvrir par programmation à l’aide de l’API REST de prise en charge Azure.
ResourceNotAvailableForSubscription La ressource n’est actuellement pas disponible à l’emplacement de l’abonnement demandé. Ouvrez une nouvelle demande de support dans le Portail Azure. Sous Sélectionner un type de problème, choisissez Limites de service et d’abonnement (quotas). Vous pouvez également l’ouvrir par programmation à l’aide de l’API REST de support Azure.
UnableToIncreaseQuota Impossible d’augmenter les quotas pour les abonnements demandés. Ouvrez une nouvelle demande de support dans le Portail Azure. Sous Sélectionner un type de problème, choisissez Limites de service et d’abonnement (quotas).

Support dans d’autres langages et interfaces

L’API REST de quota est disponible dans les kits SDK Microsoft Azure spécifiques à la langue suivants :

  • kit de développement logiciel Microsoft Azure SDK pour .NET : package NuGet
  • Kit de développement logiciel (SDK) Microsoft Azure pour Python : package Py
  • Kit de développement logiciel (SDK) Microsoft Azure pour JavaScript (NodeJS & Browser) : package js
  • Kit de développement logiciel (SDK) Microsoft Azure pour Go : package Go

Utilisation de Portail Azure et de l’API de support pour gérer les quotas

Azure vous permet de créer et gérer les demandes de support, également appelées tickets de support. Vous pouvez :