Partager via

Trouver les codes d’erreur

En cas d’échec d’un déploiement de ressources Azure à l’aide de modèles Azure Resource Manager (modèles ARM) ou de fichiers Bicep, un code d’erreur est reçu. Cet article explique comment trouver des codes d’erreur afin de résoudre le problème. Pour plus d’informations sur les codes d’erreur, consultez Erreurs de déploiement courantes.

Types d’erreurs

Il existe trois types d’erreurs liées à un déploiement :

  • Les erreurs de validation se produisent avant le début d’un déploiement et sont provoquées par des erreurs de syntaxe dans votre fichier. Un éditeur de code comme Visual Studio Code peut identifier ces erreurs.
  • Des erreurs de validation préalable se produisent lorsqu’une commande de déploiement est exécutée, mais que les ressources ne sont pas déployées. Ces erreurs sont détectées sans commencer le déploiement. Par exemple, si une valeur de paramètre est incorrecte, l’erreur est détectée lors de la validation préalable.
  • Les erreurs de déploiement se produisent pendant le processus de déploiement et ne peuvent être détectées qu’en évaluant la progression du déploiement dans votre environnement Azure.

Tous les types d’erreurs retournent un code d’erreur que vous utilisez pour résoudre les problèmes de déploiement. Les erreurs de validation et les erreurs de vérification préalable sont affichées dans le journal d’activité, mais n’apparaissent pas dans votre historique de déploiement. Un fichier Bicep avec des erreurs de syntaxe ne se compile pas en JSON et n’est pas affiché dans le journal d’activité.

Pour identifier les erreurs de syntaxe, vous pouvez utiliser Visual Studio Code avec la dernière extension Bicep ou l’extension Azure Resource Manager Tools.

Erreurs de validation

Les modèles sont validés pendant le processus de déploiement et les codes d’erreur sont affichés. Avant d’exécuter un déploiement, vous pouvez identifier les erreurs de validation et de contrôle en amont en exécutant des tests de validation avec Azure PowerShell ou Azure CLI.

Un modèle ARM peut être déployé à partir du portail. Si le modèle comporte des erreurs de syntaxe, une erreur de validation s’affiche lorsque vous essayez d’exécuter le déploiement. Pour plus d’informations sur les déploiements de portail, consultez Déployer des ressources à partir d’un modèle personnalisé.

L’exemple suivant tente de déployer un compte de stockage et une erreur de validation se produit.

Capture d’écran d’une erreur de validation dans le portail Azure pour une tentative de déploiement de compte de stockage.

Sélectionnez le message pour obtenir plus d’informations. Le modèle comporte une erreur de syntaxe avec le code InvalidTemplated’erreur . Le résumé indique qu’il manque une parenthèse fermante à une expression.

Capture d’écran d’un message d’erreur de validation dans le portail Azure, montrant une erreur de syntaxe avec le code d’erreur InvalidTemplate.

Erreurs de déploiement

Plusieurs opérations sont traitées pour déployer une ressource Azure. Des erreurs de déploiement se produisent lorsqu’une opération réussit la validation, mais échoue pendant le déploiement. Vous pouvez afficher des messages sur chaque opération de déploiement et chaque déploiement pour un groupe de ressources.

Pour afficher des messages concernant les opérations d’un déploiement, utilisez le journal d’activité du groupe de ressources :

  1. Connectez-vous au portail Azure.

  2. Accédez à Groupes de ressources et sélectionnez le nom du groupe de ressources du déploiement.

  3. Sélectionnez Journal d’activité.

  4. Utilisez les filtres pour trouver le journal des erreurs d’une opération.

    Capture d’écran du journal d’activité du groupe de ressources du portail Azure, mettant l’accent sur un déploiement ayant échoué avec un journal d’erreurs.

  5. Sélectionnez le journal des erreurs pour afficher les détails de l’opération.

    Capture d’écran des détails du journal d’activité dans le portail Azure, montrant le message d’erreur d’un déploiement ayant échoué et les détails de l’opération.

Pour afficher le résultat d’un déploiement :

  1. Accédez au groupe de ressources.

  2. Sélectionnez Paramètres>Déploiements.

  3. Sélectionnez Détails de l’erreur pour le déploiement.

    Capture d’écran de la section des déploiements d’un groupe de ressources dans le portail Azure, affichant un lien vers les détails de l’erreur pour un déploiement ayant échoué.

  4. Le message d’erreur et le code NoRegisteredProviderFound d’erreur s’affichent.

    Capture d’écran d’un résumé d’erreur de déploiement dans le portail Azure, affichant le message d’erreur et le code d’erreur NoRegisteredProviderFound.

Étapes suivantes