Comprendre les connecteurs

Workflows publie des connecteurs pour faciliter l'accès à d'autres produits Google Cloud au sein d'un workflow. Pour obtenir une documentation détaillée sur les connecteurs disponibles, consultez la documentation de référence sur les connecteurs.

Vous pouvez utiliser des connecteurs pour vous connecter à d'autres API Google Cloud au sein d'un workflow et pour intégrer vos workflows à ces produits Google Cloud. Par exemple, vous pouvez utiliser des connecteurs pour publier des messages Pub/Sub, lire ou écrire des données dans une base de données Firestore ou récupérer des clés d'authentification depuis Secret Manager. Découvrez comment utiliser un connecteur.

Les connecteurs simplifient les appels de services, car ils gèrent la mise en forme des requêtes à votre place, en fournissant des méthodes et des arguments pour que vous n'ayez pas besoin de connaître les détails d'une API Google Cloud.

Les connecteurs ont un comportement pour la relance et les opérations de longue durée intégré.

Authentification

Les connecteurs utilisent l'authentification intégrée Identity and Access Management pour interagir avec d'autres produits Google Cloud. Notez qu'un workflow utilisant un connecteur doit toujours disposer des autorisations appropriées pour son compte de service afin de s'authentifier correctement auprès d'une API donnée. Par exemple, pour publier un message dans Pub/Sub, le compte de service associé à votre workflow doit disposer du rôle roles/pubsub.publisher. Pour en savoir plus sur l'authentification auprès d'autres produits Google Cloud, consultez la page Accorder à un workflow l'accès aux ressources Google Cloud.

Tentatives

Tous les connecteurs appliquent les règles de nouvelle tentative et les configurations de traitement des erreurs suivantes:

Opérations de longue durée

Pour les appels effectuant une opération de longue durée, les comportements suivants s'appliquent:

  • Workflows bloque l'exécution du workflow jusqu'à ce que l'opération aboutisse ou échoue.

  • Par défaut, les appels expirent au bout de 30 minutes. Le délai avant expiration de l'appel peut être modifié à l'aide du champ connector_params (jusqu'à un an). Consultez la documentation de référence sur les connecteurs.

  • Les connecteurs interrogent régulièrement les opérations de longue durée. Par défaut, Workflows utilise un intervalle exponentiel entre les tentatives de 1,25 entre les interrogations, commençant avec 1 seconde, puis ralentissant jusqu'à 60 secondes entre les interrogations. Chaque tentative d'interrogation est comptabilisée comme une étape facturable. Les paramètres d'interrogation peuvent être modifiés à l'aide du champ connector_params. Consultez la documentation de référence sur les connecteurs

  • Le mécanisme de nouvelle tentative précédent s'applique aux tentatives d'interrogation ayant échoué.

  • Les réponses aux sondages sont vérifiées. Si la charge utile de la réponse n'est pas valide, une erreur ResponseTypeError est renvoyée.

  • Lorsqu'une erreur se produit lors d'une opération de longue durée, les workflows génèrent une erreur OperationError. L'erreur inclut un attribut supplémentaire, error, qui contient des détails spécifiques à l'opération.

Si une opération de longue durée échoue, l'appel du connecteur génère une exception avec les attributs suivants:

  • message: message d'erreur lisible par l'utilisateur.
  • tags: liste de tags. Pour un appel de connecteur d'opération de longue durée, la liste inclut OperationError.
  • operation: objet d'opération de longue durée ayant échoué.

Pour obtenir la liste détaillée des types d'opérations de longue durée acceptés, consultez la documentation de référence sur les connecteurs.

Étape suivante