Informazioni sui connettori

Workflows pubblica connettori per facilitare l'accesso ad altri prodotti Google Cloud all'interno di un flusso di lavoro. Per un riferimento dettagliato dei connettori disponibili, consulta la documentazione di riferimento sui connettori.

I connettori possono essere utilizzati per connettersi ad altre API Google Cloud all'interno di un flusso di lavoro e per integrare i tuoi flussi di lavoro con questi prodotti Google Cloud. Ad esempio, puoi utilizzare i connettori per pubblicare messaggi Pub/Sub, leggere o scrivere dati in un database Firestore o recuperare le chiavi di autenticazione da Secret Manager. Scopri come utilizzare un connettore.

I connettori semplificano i servizi di chiamata perché gestiscono la formattazione delle richieste per conto tuo, fornendo metodi e argomenti in modo che non sia necessario conoscere i dettagli di un'API Google Cloud.

I connettori hanno un comportamento integrato per la gestione dei nuovi tentativi e delle operazioni a lunga esecuzione.

Autenticazione

I connettori utilizzano l'autenticazione integrata di Identity and Access Management per interagire con altri prodotti Google Cloud. Tieni presente che un flusso di lavoro che utilizza un connettore deve comunque avere le autorizzazioni appropriate assegnate all'account di servizio per eseguire correttamente l'autenticazione in una determinata API. Ad esempio, per pubblicare un messaggio in Pub/Sub, all'account di servizio associato al tuo flusso di lavoro deve essere concesso il ruolo roles/pubsub.publisher. Per scoprire di più sull'autenticazione in altri prodotti Google Cloud, consulta Concedere l'autorizzazione dei flussi di lavoro per accedere alle risorse Google Cloud.

Nuovi tentativi

Tutti i connettori applicano le seguenti configurazioni dei criteri di ripetizione dei tentativi e di gestione degli errori:

Operazioni a lunga esecuzione

Per le chiamate che eseguono un'operazione a lunga esecuzione, si applicano i seguenti comportamenti:

  • Workflows blocca l'esecuzione del flusso di lavoro finché l'operazione non viene completata o meno.

  • Per impostazione predefinita, le chiamate scadono dopo 30 minuti. Il timeout della chiamata può essere modificato utilizzando il campo connector_params (fino a un massimo di un anno). Consulta la documentazione di riferimento sui connettori.

  • I connettori eseguono il polling periodico delle operazioni a lunga esecuzione. Per impostazione predefinita, Workflows utilizza un backoff esponenziale di 1,25 durante il polling, che inizia con 1 secondo e rallenta a 60 secondi tra un sondaggio e l'altro. Ogni tentativo di polling viene conteggiato come un passaggio fatturabile. I parametri di polling possono essere modificati utilizzando il campo connector_params. Consulta la documentazione di riferimento sui connettori.

  • Il meccanismo di nuovo tentativo precedente si applica a un tentativo di polling non riuscito.

  • Le risposte al sondaggio vengono controllate e, se il payload di risposta non è valido, viene restituito un errore ResponseTypeError.

  • Quando si verifica un errore durante un'operazione a lunga esecuzione, Workflows genera un errore OperationError. L'errore include un attributo aggiuntivo, error, contenente dettagli specifici dell'operazione.

Se un'operazione a lunga esecuzione non va a buon fine, la chiamata del connettore genera un'eccezione con i seguenti attributi:

  • message: messaggio di errore leggibile.
  • tags: un elenco di tag. Per una chiamata connettore per un'operazione a lunga esecuzione, l'elenco include OperationError.
  • operation: l'oggetto delle operazioni a lunga esecuzione non riuscito.

Per un elenco dettagliato dei tipi di operazione a lunga esecuzione supportati, consulta la documentazione di riferimento sui connettori.

Passaggi successivi