Azure Quota Service API

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

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 :

1. Obtenez les quotas et les utilisations actuels d’une ressource.
2. Obtenez la liste des quotas actuels et des utilisations de toutes les ressources.
3. Créer ou mettre à jour des quotas d’une ressource.
4. Obtenez le status des demandes de quota pour une ressource.
5. 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

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

Prérequis

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

1. 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.

2. 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 %.

3. 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.

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 :

• Créez un ticket de support à l’aide du Portail Azure.
• Créez un ticket de support programmatiquement à l’aide de l’API REST de ticket support Azure.