Consultez la liste des connecteurs compatibles avec Application Integration.

Erreurs et traitement des erreurs

Dans Application Integration, des erreurs peuvent se produire lorsque vous testez et publiez une intégration, ou pendant l'exécution d'une intégration. Ces erreurs peuvent se produire en raison de divers problèmes côté client et côté serveur. Elles sont généralement classées comme suit :

  • Erreurs permanentes : toutes les erreurs côté client, telles que les échecs d'authentification ou les erreurs de validation des données, sont considérées comme des erreurs permanentes. Les erreurs permanentes entraînent des échecs permanents de la tâche.
  • Erreurs temporaires : toutes les erreurs côté serveur, telles que les erreurs HTTP 503 (service indisponible) et HTTP 400 (requête incorrecte), sont considérées comme des erreurs temporaires. Les erreurs temporaires entraînent des échecs temporaires de la tâche.

Les messages d'erreur s'affichent aux emplacements suivants :

  • Page des journaux d'exécution : affiche les erreurs rencontrées lors de l'exécution d'une intégration. Chaque exécution d'une intégration possède une entrée de journal distincte. Pour en savoir plus sur la page des journaux d'exécution, consultez la section Journaux d'exécution.
  • Page de l'éditeur d'intégrations : affiche les erreurs rencontrées lors de la publication d'une intégration. Les erreurs s'affichent au bas de la page de l'éditeur d'intégrations. Pour en savoir plus sur la page de l'éditeur d'intégrations, consultez la page Éditeur d'intégrations.

Pour en savoir plus sur la liste des codes d'erreur que vous pouvez rencontrer, consultez la section Codes d'erreur.

Méthodes de traitement des erreurs

Application Integration propose plusieurs méthodes de gestion des exceptions pour répondre aux erreurs qui se produisent lors de la création, du test, de la publication ou de l'exécution de vos intégrations. Vous pouvez utiliser des méthodes de gestion des exceptions pour les modes synchrones et asynchrones d'exécution de l'intégration:

  • Exécutions synchrones:en mode synchrone, le résultat de l'intégration est disponible peu après son exécution. Le mode synchrone est utile dans les cas où vous souhaitez obtenir le résultat de l'exécution immédiatement après l'exécution de l'intégration. Voici quelques déclencheurs qui exécutent l'intégration en mode synchrone :
  • Exécutions asynchrones:les exécutions asynchrones utilisent le modèle de déclenchement et d'oubli. Le mode asynchrone est utile dans les cas où l'exécution des intégrations peut prendre beaucoup de temps ou que le résultat de l'exécution n'est pas requis immédiatement après l'exécution de l'intégration. Voici des déclencheurs qui exécutent l'intégration en mode asynchrone :

Application Integration est compatible avec les méthodes de gestion des exceptions suivantes pour générer, intercepter, relancer et personnaliser les erreurs rencontrées dans votre intégration:

Codes d'erreur

Le tableau suivant décrit les erreurs susceptibles de se produire et leur origine. Application Integration utilise les codes d'erreur canoniques définis dans google.rpc.Code.

Pour en savoir plus sur les erreurs d'Application Integration et sur les différentes stratégies de gestion des exceptions, consultez Erreurs et gestion des erreurs.

Type d'exception standard Code canonique Code HTTP Description
FailedPreconditionException FAILED_PRECONDITION 400 La requête ne peut pas être exécutée dans l'état actuel du système.
BadRequestException INVALID_ARGUMENT 400 Le client a spécifié un argument incorrect. Consultez le message d'erreur et les détails de l'erreur pour plus d'informations.
UnauthenticatedException UNAUTHENTICATED 401 La requête n'a pas été authentifiée en raison d'un jeton OAuth manquant, non valide ou ayant expiré.
ForbiddenException PERMISSION_DENIED 403 Le client ne dispose pas d'une autorisation suffisante. Cela peut se produire si le jeton OAuth ne dispose pas des champs d'application appropriés, si le client ne dispose pas des autorisations requises ou si l'API n'a pas été activée.
NotFoundException NOT_FOUND 404 Une ressource spécifiée est introuvable.
AlreadyExistsException ALREADY_EXISTS 409 La ressource qu'un client a essayé de créer existe déjà.
InternalError INTERNAL 500 Erreur interne au serveur. Généralement un bug de serveur. Cela peut se produire si l'une des tâches ou les déclencheurs sont mal configurés.
UnimplementedException UNIMPLEMENTED 501 Méthode d'API non mise en œuvre par le serveur.
ServiceUnavailableException UNAVAILABLE 503 Service indisponible. Généralement, le serveur est inactif.
AbortedException ABORTED 409 La taille de la réponse est trop importante.