Lexique des codes d'erreur Power Automate : les principales erreurs HTTP et de connecteur

Un flux passe au rouge, l'historique d'exécution affiche un code d'erreur comme 403 ou un nom interne comme ActionFailed, et le message d'erreur en lui-même ne t'aide pas vraiment à avancer. C'est exactement là que la recherche commence : est-ce un problème de connexion, de données d'entrée ou du service cible ? Sans référence, chaque incident te coûte un temps précieux, car tu dois d'abord découvrir ce que le code signifie.

Ce lexique résume les codes de statut HTTP les plus importants et les noms d'erreur typiques propres à Power Automate, tels qu'ils sont documentés dans la référence des codes d'erreur pour les flux cloud officielle de Microsoft. Pour chaque erreur, tu obtiens une brève explication de sa signification, des causes les plus fréquentes et de l'endroit où regarder en premier. Il te suffit de rechercher le code qui apparaît actuellement dans ton historique d'exécution.

Les codes de statut HTTP en un coup d'œil

De nombreuses erreurs de connecteur dans Power Automate sont en fin de compte des codes de statut HTTP classiques renvoyés par l'API appelée. Microsoft répertorie les plus fréquents dans la documentation sur l'intégrité des connecteurs :

• 400 Bad Request: Le serveur ne peut pas ou ne veut pas traiter la demande car les données d'entrée sont incorrectes.
• 401 Unauthorized: L'authentification a échoué, les identifiants valides sont manquants.
• 403 Forbidden: Une limite de débit de l'API a été dépassée ou l'autorisation est manquante.
• 404 Not Found: L'opération appelée n'existe plus ou a été marquée comme obsolète.
• 409 Conflict: La requête entre en conflit avec l'état actuel de la ressource cible, souvent résoluble en renvoyant la requête après correction.
• 415 Unsupported Media Type: Le type de contenu de la requête n'est pas pris en charge par le serveur.
• 429 Too Many Requests: La limite de débit de l'API est atteinte.
• 500 Internal Server Error: Une erreur inattendue côté serveur.
• 502 Bad Gateway: Un problème au niveau du serveur web d'hébergement, souvent une connexion fermée.
• 504 Gateway Timeout: Le serveur ne répond pas à temps.
• 522, 523, 524: Erreurs de connexion ou de dépassement de délai, généralement causées par un service cible inaccessible ou surchargé.

Bon à savoir : les erreurs dans la plage 400 sont presque toujours dues à la requête elle-même, tandis que les erreurs dans la plage 500 indiquent un problème du côté du service appelé et ne se résolvent généralement qu'en attendant ou en réessayant.

Erreurs de connexion et d'authentification

Ce groupe d'erreurs se produit lorsque le flux ne peut plus se connecter à un service connecté.

• InvalidConnection: La référence de connexion pointe vers une connexion supprimée, expirée ou interrompue. Ouvre le flux, sélectionne l'action concernée et recrée la connexion.
• ConnectionNotConfigured: Une action nécessite une connexion, mais aucune n'a été sélectionnée, souvent après une importation depuis une solution. Sélectionne la connexion appropriée dans l'action.
• ConnectionAuthorizationFailed: La connexion existe, mais ses identifiants enregistrés ne sont plus valides, par exemple parce qu'un mot de passe a été modifié ou qu'un jeton OAuth a expiré après 90 jours d'inactivité. Va dans Connexions, sélectionne la connexion concernée et utilise Corriger la connexion.
• Unauthorized (401): Le jeton d'authentification est invalide ou expiré. Vérifie également les journaux de connexion dans Microsoft Entra ID pour détecter des blocages dus à l'accès conditionnel.
• Forbidden (403): L'utilisateur ou l'application n'est pas autorisé à effectuer l'opération. La cause la plus fréquente est une stratégie DLP qui bloque le connecteur dans l'environnement, ou des autorisations manquantes sur la ressource cible.

Pour les flux de production, selon la documentation Microsoft, il est intéressant de passer à une connexion par principal de service, car celle-ci n'expire pas lorsqu'un collaborateur change son mot de passe ou quitte l'entreprise.

Erreurs de connecteur et d'API

Ces erreurs proviennent du service appelé lui-même, pas de Power Automate.

• ActionFailed: Un message d'erreur générique signifiant qu'une action a échoué. La cause réelle se trouve dans le texte de sortie de l'action ; ouvre l'exécution échouée et déplie Sorties.
• BadRequest (400): Les données d'entrée sont mal formatées, par exemple une chaîne de caractères là où un nombre est attendu, ou un champ obligatoire est manquant dans le corps de la requête.
• NotFound (404): La ressource référencée, par exemple une liste SharePoint ou un dossier de boîte aux lettres, a été renommée, déplacée ou supprimée.

Pour ces trois erreurs, la même première étape aide : ouvrir l'exécution échouée dans l'historique d'exécution et comparer les entrées avec le format réellement attendu.

Erreurs de conception et d'expression

Ces erreurs apparaissent soit lors de l'enregistrement, soit seulement à l'exécution, lorsqu'une expression est évaluée.

• InvalidTemplate: Une erreur de syntaxe dans une expression, souvent des parenthèses non correspondantes ou un nom d'action incorrect.
• FlowCheckerError: Le vérificateur de flux a trouvé un problème de validation, généralement un champ obligatoire vide ou une connexion manquante.
• DuplicateActionName: Deux actions dans le même flux portent en interne le même nom, souvent après un copier-coller sans renommage.
• MissingRequiredProperty: Un champ obligatoire dans une action ou dans le déclencheur est resté vide.
• ExpressionEvaluationFailed: Une expression ne peut pas être évaluée à l'exécution car les données réelles ne correspondent pas à l'expression, par exemple l'accès à un champ d'un objet vide. Une protection `coalesce()` résout généralement ce problème.
• ContentConversionFailed: Le flux n'a pas pu convertir des données d'un type à un autre, par exemple une date dans un format inattendu.

Erreurs de délai d'attente et de limitation

Ce groupe se produit dès qu'un flux dépasse des limites de temps ou de volume.

• ActionTimedOut: Une action individuelle a dépassé son délai configuré ; le délai d'expiration par défaut d'une action HTTP est de 100 secondes.
• OperationTimedOut: Une opération de longue durée, comme une approbation ou un webhook, a dépassé le temps d'attente maximal. Selon la documentation, les flux cloud s'exécutent pendant 30 jours maximum.
• WorkflowRunActionRepetitionQuotaExceeded: Une boucle comme « Appliquer à chacun » a dépassé le nombre maximal d'itérations, souvent à cause de boucles imbriquées sans filtrage préalable.
• FlowRunQuotaExceeded: La limite quotidienne d'exécutions d'actions pour l'utilisateur ou le flux est atteinte, selon le niveau de licence.
• DirectApiAuthorizationRequired: Le flux utilise un connecteur premium, mais l'utilisateur déclencheur ne dispose pas de la licence appropriée.

Comment procéder de façon systématique

Plutôt que de chercher chaque erreur individuellement sur Google, une séquence fixe est utile, comme le décrit aussi Microsoft dans le guide Résolution des erreurs de flux cloud :

• Ouvre l'exécution échouée dans l'historique d'exécution et identifie l'action marquée en rouge.
• Déplie Entrées et Sorties de l'action pour voir le code de statut exact et le message d'erreur.
• Associe le code à la catégorie correspondante de ce lexique : connexion, requête, expression ou délai d'attente.
• Si tu ne trouves pas le texte de l'erreur dans cet aperçu, copie-le mot pour mot et recherche-le dans les forums communautaires de Power Automate, où presque tous les cas particuliers ont déjà été discutés.

Si un flux chez vous se bloque régulièrement sur les mêmes codes d'erreur, ou si vous ne parvenez pas à cerner la cause malgré cette référence, nous nous en occupons volontiers ensemble dans le cadre de notre conseil Power Automate. En tant qu'employés numériques, nous mettons en place proprement les connexions, la gestion des erreurs et la logique de nouvelle tentative une bonne fois pour toutes, et les documentons afin que tu gardes ensuite le contrôle de tes flux.

Questions fréquentes

Quelle est la différence entre un code de statut HTTP et une erreur comme ActionFailed ?

Les codes de statut HTTP comme 401 ou 404 proviennent directement du service appelé et décrivent pourquoi la requête concrète a échoué. Les erreurs comme ActionFailed sont en revanche un wrapper générique de Power Automate, derrière lequel se cache presque toujours l'un de ces codes HTTP. Ouvre les sorties de l'action échouée pour trouver le code de statut réel qui se cache derrière.

Pourquoi est-ce que je reçois une erreur 403 alors que mes identifiants sont corrects ?

Une erreur 403 ne signifie pas forcément des identifiants incorrects, mais plutôt une autorisation manquante pour l'opération concrète. Les causes les plus fréquentes sont une stratégie de prévention de la perte de données qui bloque le connecteur dans ton environnement, un accès en écriture manquant sur la ressource cible, ou une limite de débit de l'API dépassée. Vérifie d'abord les autorisations sur la ressource cible, puis les stratégies DLP dans ton environnement.

Comment savoir quelle action a causé une erreur ?

Ouvre le flux concerné, sélectionne l'exécution échouée dans la liste des dernières exécutions et recherche l'icône d'avertissement rouge. Tu peux déplier l'action concernée ; les sections Entrées et Sorties y affichent le code de statut exact et le message d'erreur original du service appelé.

Vaut-il la peine de corriger immédiatement chaque erreur soi-même ?

Pour les erreurs HTTP ponctuelles comme une 429 ou une 502, une nouvelle tentative suffit généralement, car la cause se situe du côté du service externe et est temporaire. Si la même erreur se produit de manière répétée en revanche, il est utile de mettre en place une gestion structurée des erreurs dans le flux, par exemple avec des règles de nouvelle tentative et une action de repli définie, plutôt que de tout relancer manuellement à chaque fois.

Ces codes d'erreur s'appliquent-ils aussi aux flux de bureau ?

Les codes décrits ici concernent les flux cloud. Pour les flux de bureau, qui s'exécutent sur ton PC, Microsoft tient une référence distincte intitulée Gestion des erreurs de flux de bureau, car d'autres sources d'erreurs, comme les éléments d'interface utilisateur ou les applications locales, y jouent un rôle.