Informazioni sui connettori

Workflows pubblica connettori per facilitare l'accesso ad altre i prodotti Google Cloud all'interno di un flusso di lavoro. Per un riferimento dettagliato delle connettori, consulta Informazioni sui connettori.

I connettori possono essere utilizzati per connettersi ad altre API Google Cloud all'interno e integrare i tuoi flussi di lavoro con quelle di Google Cloud prodotti di big data e machine learning. 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 le chiamate ai servizi perché gestiscono la formattazione richieste per te, 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 tentativi e operative a lunga esecuzione.

Autenticazione

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

Nuovi tentativi

Tutti i connettori applicano quanto segue riprova criterio ed errore gestione delle configurazioni:

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 viene completata correttamente o non va a buon fine.

  • Per impostazione predefinita, le chiamate scadono dopo 30 minuti. Il timeout della chiamata può essere modificata utilizzando il campo connector_params (per un massimo di un anno). Consulta le Informazioni sui connettori.

  • I connettori eseguono periodicamente il polling delle operazioni a lunga esecuzione. Per impostazione predefinita, Workflows utilizza un backoff esponenziale di 1,25 durante l'esecuzione di polling, iniziando con 1 secondo e rallentando fino a 60 secondi tra un polling 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 l'articolo Informazioni di riferimento sui connettori.

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

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

  • Quando si verifica un errore durante un'operazione che richiede molto tempo, Workflows genera un errore OperationError. L'errore include un attributo aggiuntivo, error, che contiene dettagli specifici per l'operazione.

Se un'operazione di lunga durata non riesce, la chiamata del connettore genera un'eccezione con i seguenti attributi:

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

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

Passaggi successivi