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 zur Verwendung eines Connectors
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 Workflowberechtigung für den Zugriff auf Google Cloud-Ressourcen gewähren.
Wiederholungsversuche
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_paramskonfigurieren. 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 über das Feld
connector_paramsgeändert werden (maximal ein 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_paramsgeä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 der Fehler
ResponseTypeErrorzurückgegeben.Wenn während eines lang andauernden Vorgangs ein Fehler auftritt, löst Workflows den Fehler
OperationErroraus. Der Fehler enthält das zusätzliche Attributerror, 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 ListeOperationError.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.