Azure Quota Service API

Article
02/03/2024

L’API REST Azure Quota Service est conçue pour l’affichage et la gestion des quotas pour les fournisseurs de ressources Azure.

Important

L’API Azure Quota Service est en préversion publique

Une nouvelle version de l’API Quota Azure est disponible en préversion publique. Cette API utilise le fournisseur de ressources Microsoft.Quota, prend en charge les machines virtuelles Azure (cœurs/processeurs virtuels), Azure Machine Learning (dédié/processeur virtuel), la mise en réseau, azure HPC Cache, le stockage et les services Azure Purview.

Un quota est la limite de service ou l’allocation définie sur une ressource dans votre abonnement Azure. Chaque service Azure définit ses quotas et détermine ses valeurs par défaut. Pour plus d’informations sur les quotas Microsoft Azure les plus courants, consultez Limites, quotas et contraintes d’abonnement et de service Azure.

Utilisation des API de 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.
Obtenir la liste de toutes les demandes de quota d’une ressource pendant un an

Appel et étendue de l’API PUT de quota

La demande PUT de l’API quota inclut un paramètre « étendue » qui peut être personnalisé pour s’aligner sur les exigences des fournisseurs de ressources qui cherchent une augmentation de quota, garantissant ainsi que l’appel d’API reste uniforme.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview

Fournisseur de ressources	Étendue
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}

Remarque : Vous trouverez un exemple d’appel PUT pour le calcul ici.

Prérequis

Important

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

Inscrivez le fournisseur de ressources Microsoft.Quota pour tous vos abonnements à l’aide de PowerShell.
Attribuez le rôle Opérateur de demande de quota à tous les comptes d’utilisateur et applications qui effectueront des opérations de quota.

Inscription du fournisseur de ressources De quota Microsoft

Pour inscrire le fournisseur de ressources Microsoft Quota, utilisez la commande PowerShell ci-dessous :

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Il retourne des résultats similaires à la sortie ci-dessous :

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

Une fois que le fournisseur de ressources Microsoft.Quota est 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.

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ôle opérateur de requête de quota

L’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.

Le rôle Opérateur de demande de quota est étendu pour inclure les autorisations du fournisseur de ressources de quota.

Bonnes pratiques pour les API de quota

Surveillance de l’utilisation des quotas : Utilisez l’API de quota Azure pour suivre efficacement l’utilisation de votre quota. Cette API fournit des informations en temps réel sur votre utilisation actuelle et le quota disponible pour une combinaison spécifique d’abonnement, de famille de machines virtuelles et de région. Il est essentiel de case activée régulièrement l’utilisation de votre quota avant d’envisager une augmentation de quota.
Demande d’augmentation de quota : Si l’utilisation de votre quota dépasse la cible prédéfinie, lancez une demande d’augmentation de quota à l’aide de l’API de quota Azure pour rétablir votre utilisation en ligne avec vos objectifs. Le processus est simple : il vous suffit d’envoyer une demande d’API qui décrit l’augmentation de quota souhaitée. Par exemple, si l’utilisation cible du quota de la famille de machines virtuelles Dv2 en Europe Nord, sous « abonnement1 », est définie sur 80 %, et que la surveillance de votre API de quota Azure indique une utilisation réelle de 85 %, envoyez une augmentation de quota de 10 % à 20 %.

Conseil

Il est conseillé de demander une augmentation du quota de 10 % à 20 % de l’utlisation des ressources, car elle fournit une mémoire tampon résonable pour les pics inattendus d’utilisation des ressources, garantissant ainsi que vous n’atteindrez pas immédiatement votre nouvelle limite de quota après une augmentation . Cette approche réduit le besoin d’appels d’API fréquents pour demander un quota supplémentaire, ce qui améliore vos chances d’approbation.

Respnose de l’augmentation du quota : Lors de l’envoi d’une demande d’augmentation de quota, vous recevrez une réponse indiquant si votre demande a été approuvée ou rejetée. En cas de rejet, vous pouvez lancer un suivi en journalisant une demande de support à l’aide de l’API REST de support Azure ou en utilisant une nouvelle demande de support dans le Portail Azure, y compris les spécificités de la demande d’augmentation de quota refusée et la raison de votre demande.

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.Quota 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).
MFA obligatoire	Les demandes de quota nécessitent l’authentification multifacteur. Activez l’authentification multifacteur pour votre locataire/compte en suivant les instructions de la page Activer l’authentification multifacteur , puis réessayez.
RequestPartiallyFulfilled	La demande de quota est partiellement satisfaite. Pour toute question, 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 Java : package Java
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 JavaScript
Kit de développement logiciel (SDK) Microsoft Azure pour Go : package Go
Extensions Microsoft Azure CLI : package Cli

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 :

Partager via