Cette page a été traduite par l'API Cloud Translation.
Switch to English

Connecteurs

Les workflows publient des connecteurs pour faciliter l'accès aux autres produits Google Cloud au sein d'un workflow. Pour obtenir une référence détaillée des connecteurs disponibles, consultez la documentation de référence des connecteurs. Pour obtenir des exemples de workflows qui montrent comment utiliser un connecteur, consultez la page Exemples de connecteurs.

Les connecteurs peuvent être utilisés pour se connecter à d'autres API Google Cloud au sein d'un workflow, ce qui vous aide à intégrer vos workflows à d'autres 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 encore récupérer des clés d'authentification à partir de Secret Manager.

Authentification

Les connecteurs utilisent l'authentification intégrée de Identity and Access Management pour interagir avec d'autres produits Google Cloud. Notez qu'un workflow utilisant un connecteur doit tout de même disposer des autorisations appropriées affectées à son compte de service pour s'authentifier correctement auprès d'une API donnée. Par exemple, pour publier un message sur 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 Effectuer des requêtes authentifiées à partir d'un workflow.

Comportement lors des nouvelles tentatives et des opérations de longue durée

Les connecteurs intègrent un comportement intégré pour gérer les nouvelles tentatives et les opérations de longue durée.

Tentatives

Tous les connecteurs appliquent la stratégie 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:

  • Les workflows bloquent l'exécution du workflow jusqu'à la fin ou l'échec de l'opération.

  • Les appels expirent après 30 minutes.

  • Les connecteurs interrogent régulièrement les opérations de longue durée. Les workflows utilisent un intervalle exponentiel entre les tentatives de 1,25 lors de l'interrogation, en commençant par une seconde et en ralentissant 60 secondes entre les sondages. Chaque tentative d'interrogation est comptabilisée comme une étape facturable.

  • 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 informations spécifiques à l'opération.

Firestore

Le connecteur Firestore vous permet de vous connecter aux API Firestore à partir d'un workflow.

Le connecteur Firestore n'est compatible qu'avec les bases de données créées en mode natif. Les opérations échouent si elles sont utilisées sur une base de données en mode Datastore. Pour en savoir plus sur la différence entre le mode natif et le mode Datastore,consultez la page Choisir entre le mode natif et le mode Datastore.