Connectors

In Workflows werden Connectors veröffentlicht, damit Sie einfacher auf andere Google Cloud-Produkte in einem Workflow zugreifen können. Eine ausführliche Referenz zu den verfügbaren Connectors finden Sie in der Connector-Referenz.

Connectors können verwendet werden, um eine Verbindung zu anderen Google Cloud APIs innerhalb eines Workflows herzustellen und Workflows in diese Google Cloud-Produkte zu integrieren. Mit Connectors können Sie beispielsweise Pub/Sub-Nachrichten veröffentlichen, Daten in einer Firestore-Datenbank lesen oder schreiben oder Authentifizierungsschlüssel aus Secret Manager abrufen.

Connectors vereinfachen den Aufruf von Diensten, da sie die Formatierung von Anfragen für Sie übernehmen. Außerdem stellen sie Ihnen Methoden und Argumente bereit, damit Sie die Details einer Google Cloud API nicht kennen müssen.

Connectors haben ein integriertes Verhalten für die Durchführung von Wiederholungsversuchen und lang andauernden Vorgängen.

Authentifizierung

Connectors nutzen die integrierte Authentifizierung der Identitäts- und Zugriffsverwaltung, um mit anderen Google Cloud-Produkten zu interagieren. Ein Workflow mit einem Connector muss dem Dienstkonto dennoch die entsprechenden Berechtigungen haben, um sich bei einer bestimmten API richtig zu authentifizieren. Wenn Sie beispielsweise eine Nachricht in Pub/Sub veröffentlichen möchten, muss dem mit Ihrem Workflow verknüpften Dienstkonto die Rolle roles/pubsub.publisher zugewiesen werden. Weitere Informationen zur Authentifizierung bei anderen Google Cloud-Produkten finden Sie unter Workflowberechtigungen für den Zugriff auf Google Cloud-Ressourcen gewähren.

Erneuter Versuch

Bei allen Connectors werden die folgenden Wiederholungsrichtlinien und Konfigurationen zur Fehlerbehandlung angewendet:

  • Workflows verwendet eine idempotente Wiederholungsrichtlinie für GET-Anfragen.

  • Für alle anderen HTTP-Methoden wird eine nicht idempotente Wiederholungsrichtlinie verwendet.

  • Standardmäßig tritt nach 30 Minuten eine Zeitüberschreitung bei Anfragen auf. Bei lang andauernden Vorgängen gilt dies für einzelne Anfragen (z. B. das Starten des Vorgangs oder das Prüfen des Status) innerhalb des lang andauernden Vorgangs. Das Zeitlimit für den gesamten Vorgang kann über das Feld connector_params konfiguriert werden. Siehe Connector-Referenz

Lang andauernde Vorgänge

Für Aufrufe mit einem lang andauernden Vorgang gelten die folgenden Verhaltensweisen:

  • Workflows blockieren die Ausführung von Workflows, bis der Vorgang erfolgreich abgeschlossen wird oder fehlschlägt.

  • Standardmäßig tritt nach 30 Minuten eine Zeitüberschreitung bei Anrufen auf. Das Zeitlimit des Aufrufs kann im Feld connector_params auf maximal ein Jahr geändert werden. Siehe Connector-Referenz

  • Connectors fragen lang andauernde Vorgänge regelmäßig ab. Standardmäßig verwendet Workflows beim Abfragen einen exponentiellen Backoff von 1,25.Er beginnt mit 1 Sekunde und wird auf 60 Sekunden zwischen Abfragen verlangsamt. Jeder Umfrageversuch zählt als kostenpflichtiger Schritt. Die Abfrageparameter können mit dem Feld connector_params geändert werden. Siehe Connector-Referenz

  • Der vorherige Wiederholungsmechanismus gilt für einen fehlgeschlagenen Abfrageversuch.

  • Wenn während eines lang andauernden Vorgangs ein Fehler auftritt, löst der Workflow den Fehler OperationError aus. Der Fehler enthält das zusätzliche Attribut error mit vorgangsspezifischen Details.

Wenn ein lang andauernder Vorgang fehlschlägt, löst der Connector-Aufruf eine Ausnahme mit den folgenden Attributen aus:

  • message: Für Menschen lesbare Fehlermeldung.
  • tags: Eine Liste von Tags. Bei einem Aufruf eines Vorgangs mit langer Ausführungszeit enthält die Liste OperationError.
  • operation: Das fehlgeschlagene Vorgangsobjekt mit langer Ausführungszeit.

Eine ausführliche Liste der unterstützten Vorgänge mit langer Ausführungszeit finden Sie in der Connector-Referenz.

Nächste Schritte