FAQ sur les erreurs de l’interface CLI de développement Azure

Cet article fournit des solutions pour les erreurs courantes que vous pouvez rencontrer lors de l’utilisation de l’interface CLI développeur Azure (azd).

Échec de l’autorisation pour l’écriture d’attribution de rôle

Message d'erreur:The template deployment failed with error: 'Authorization failed for template resource '<guid>' of type 'Microsoft.Authorization/roleAssignments'. The client '##Email##' with object id '<guid>' does not have permission to perform action 'Microsoft.Authorization/roleAssignments/write' at scope '<resourceId>'.'

Cause : Vous n'avez pas les autorisations suffisantes pour attribuer des rôles dans l'abonnement ou le groupe de ressources Azure cible. Cela est courant lorsque votre compte d'utilisateur a l'accès Contributor, mais pas l'accès Owner ni User Access Administrator. Contributor vous permet de créer des ressources, mais pas d’accorder des autorisations (attribuer des rôles) à ces ressources.

Résolution: Vérifiez que votre compte dispose du rôle Propriétaire ou Administrateur de l’accès utilisateur sur l’abonnement ou le groupe de ressources sur lequel vous effectuez le déploiement. Si vous ne pouvez pas accorder ces rôles, demandez à un administrateur d’effectuer le déploiement initial ou les attributions de rôles pour vous. Pour plus d’informations, consultez Azure rôles intégrés.

L’attribution de rôle existe déjà

Message d'erreur:The role assignment already exists.

Cause : Cette erreur se produit lorsque le déploiement tente de créer une attribution de rôle qui existe déjà sur la ressource. Bien que les déploiements Azure Resource Manager (ARM) soient idempotents, certaines configurations ou conditions de concurrence dans les modèles peuvent déclencher cette erreur lors du redéploiement.

Résolution: Cette erreur est souvent intermittente ou bénigne.

1. Réessayez le déploiement : Exécutez à nouveau azd up ou azd deploy.
2. Vérifiez les modèles Bicep : Si vous conservez le modèle, assurez-vous que les attributions de rôles utilisent des propriétés name valides (souvent des GUID strictement déterministes) pour garantir l'idempotence. Utilisez la fonction guid() Bicep pour générer des noms déterministes.

Identifiant de locataire, identifiant principal ou portée non autorisés à être mis à jour

Message d'erreur:Tenant ID, application ID, principal ID, and scope are not allowed to be updated.

Cause : Vous tentez de redéployer une attribution de rôle avec des propriétés qui diffèrent de l’attribution existante. Les attributions de rôles sont immuables ; vous ne pouvez pas modifier l’ID principal (l’utilisateur/l’application recevant le rôle) ou l’étendue d’un ID d’affectation existant.

Résolution :

1. Vérifiez les paramètres : Vérifiez que vous ne passez pas accidentellement un ID de principal différent (par exemple, le basculement entre un utilisateur et un principal de service) pour la même ressource d’attribution de rôle.
2. Clean up : Si vous devez modifier l’attribution, supprimez manuellement l’attribution de rôle en conflit dans le portail Azure ou via l’interface CLI à l’aide de az role assignment delete, puis redéployez.

Capacité de région ou référence SKU indisponible

Message d’erreur :The region 'eastus2' currently does not have enough resources available to provision services with the SKU 'standard'. (ou ' de base')

Cause : La région de Azure sélectionnée est temporairement hors capacité de la référence SKU de service demandée. Ceci est actuellement courant avec les services IA (comme Azure OpenAI) dans des régions populaires comme eastus2.

Résolution :

1. Modifier l’emplacement : Exécutez azd env set AZURE_LOCATION <new-region> pour basculer vers une région avec une meilleure disponibilité (par exemple, swedencentral, westus3, francecentral).
2. Check availability : Utilisez la page Azure Products by Region ou exécutez az account list-locations pour rechercher les régions où le service et la référence SKU sont disponibles.

Quota TPM dépassé pour les modèles IA

Message d'erreur:This operation require <amount> new capacity in quota Tokens Per Minute (thousands) - <model> - GlobalStandard, which is bigger than the current available capacity <available>.

Cause : Votre abonnement a atteint sa limite de quota pour les jetons par minute (TPM) pour le modèle OpenAI Azure spécifié dans la région cible.

Résolution :

1. Request Quota : Demander une augmentation du quota via le portail Azure AI Studio ou Azure. Pour plus d’informations, consultez Gérer le quota du service Azure OpenAI.
2. Modifier les modèles/région : Basculez vers une région où vous avez un quota inutilisé ou utilisez une autre version de modèle qui correspond à vos limites.

La précondition If-Match a échoué

Message d'erreur:The specified precondition 'If-Match = ""<guid>""' failed.

Cause : Ce problème indique généralement un conflit d’accès concurrentiel. Deux processus peuvent essayer de mettre à jour la même ressource simultanément, ou votre état local n’est pas synchronisé avec la ressource cloud (ETag obsolète).

Résolution: Réessayez l’opération. Si l’erreur persiste :

1. Vérifiez qu’aucun autre déploiement (pipelines de CI/CD, d’autres collègues) ne cible simultanément le même environnement.
2. Si vous utilisez Bicep, vérifiez que votre modèle définit correctement les dépendances (dependsOn) pour empêcher les modifications parallèles apportées à la même ressource.

Compte Cognitive Services dans l’état Accepté

Message d'erreur:Call to Microsoft.CognitiveServices/accounts failed. Error message: Account <resourceId> in state Accepted.

Cause : Cette erreur est un problème de minutage où une ressource dépendante tente d'interagir avec le compte Cognitive Services (Azure AI) avant qu'il ne soit entièrement approvisionné et actif. Vous pouvez également ajouter un hook de commande (par exemple) postprovisiondans votre azure.yaml pour suspendre ou vérifier la préparation des ressources avant de continuer.

La version provisionnée de l’application conteneur a expiré

Message d'erreur:Failed to provision revision for container app <appName>. Error details: Operation expired.

Cause : L’application conteneur Azure n’a pas pu démarrer pendant la période d’expiration par défaut. Les raisons courantes sont les suivantes :

• L'image de conteneur est trop volumineuse et prend trop de temps à télécharger.
• L’application se bloque au démarrage.
• L'application met trop de temps à écouter sur le port configuré.

Résolution :

1. Check Logs : Consultez les journaux du conteneur dans le portail Azure (Flux de journaux) ou en utilisant azd monitor pour vérifier si l’application se bloque.
2. Vérifier la configuration : Vérifiez que la targetPort configuration correspond au port sur lequel votre application écoute. Pour plus d’étapes de résolution des problèmes, consultez Troubleshooting Azure Container Apps
3. Vérifier les journaux : Afficher les journaux de conteneur dans le portail Azure (Log Stream) ou à l’aide de azd monitor pour voir si l’application se bloque.
4. Vérifier la configuration : Vérifiez que la targetPort configuration correspond au port sur lequel votre application écoute.
5. Optimiser l’image : Réduisez la taille de votre image de conteneur pour accélérer le téléchargement.