Informationen zu Connectors

Workflows veröffentlichen Connectors, um den Zugriff auf andere Google Cloud-Produkte in einem Workflow zu erleichtern. Eine detaillierte Referenz zu den verfügbaren Connectors finden Sie in der Referenz zu Connectors.

Mithilfe von Connectors können Sie eine Verbindung zu anderen Google Cloud APIs in einem Workflow herstellen und Ihre Workflows in diese Google Cloud-Produkte integrieren. Beispielsweise können Sie Connectors verwenden, um Pub/Sub-Nachrichten zu veröffentlichen, Daten in einer Firestore-Datenbank zu lesen oder zu schreiben oder Authentifizierungsschlüssel aus Secret Manager abzurufen. Weitere Informationen

Connectors vereinfachen den Aufruf von Diensten, da sie die Formatierung von Anfragen für Sie verarbeiten und Methoden und Argumente bereitstellen. Sie müssen also die Details einer Google Cloud API nicht kennen.

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

Authentifizierung

Connectors nutzen die integrierte Identitäts- und Zugriffsverwaltungsauthentifizierung, um mit anderen Google Cloud-Produkten zu interagieren. Beachten Sie, dass einem Dienstkonto, das einen Connector verwendet, dem Dienstkonto weiterhin die entsprechenden Berechtigungen zugewiesen sein müssen, um sich bei einer bestimmten API ordnungsgemäß zu authentifizieren. Damit beispielsweise eine Nachricht in Pub/Sub veröffentlicht werden kann, muss dem Dienstkonto, das Ihrem Workflow zugeordnet ist, 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.

Neuversuche

Alle Connectors wenden die folgenden Wiederholungsrichtlinien und Fehlerbehandlungskonfigurationen an:

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

  • Workflows verwenden für alle anderen HTTP-Methoden eine nicht idempotente Wiederholungsrichtlinie.

  • Standardmäßig tritt bei Anfragen nach 30 Minuten eine Zeitüberschreitung auf. Beachten Sie, dass bei lang andauernden Vorgängen einzelne Anfragen (z. B. das Starten des Vorgangs oder die Prüfung des Status) innerhalb des lang andauernden Vorgangs gelten. Das Zeitlimit für den gesamten Vorgang können Sie mit dem Feld connector_params konfigurieren. Siehe Referenz zu Connectors.

Lang andauernde Vorgänge

Für Aufrufe, die einen Vorgang mit langer Ausführungszeit ausführen, gilt Folgendes:

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

  • Zeitüberschreitung bei Aufrufen nach 30 Minuten. Das Zeitlimit des Aufrufs kann mit dem Feld connector_params geändert werden (bis zu einem Jahr). Siehe Referenz zu Connectors.

  • Connectors fragen lange laufende Vorgänge regelmäßig ab. Standardmäßig verwenden Workflows beim Abfragen einen exponentiellen Backoff von 1,25, beginnend mit 1 Sekunde und verlangsamen auf 60 Sekunden zwischen Abfragen. Jeder Abfrageversuch zählt als kostenpflichtiger Schritt. Die Abfrageparameter können im Feld connector_params geändert werden. Siehe Referenz zu Connectors.

  • Der vorherige Mechanismus für Wiederholungsversuche gilt für einen fehlgeschlagenen Abfrageversuch.

  • Umfrageantworten werden geprüft. Wenn die Antwortnutzlast ungültig ist, wird ein ResponseTypeError-Fehler zurückgegeben.

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

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 Connector-Aufruf mit lang andauerndem Vorgang enthält die Liste OperationError.
  • operation: Das fehlgeschlagene Vorgangsobjekt mit langer Ausführungszeit.

Eine detaillierte Liste der unterstützten Vorgänge mit langer Ausführungszeit finden Sie in der Referenz zu Connectors.

Nächste Schritte