Informazioni sui connettori

Workflows pubblicano connettori per semplificare 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 dei connettori.

I connettori possono essere utilizzati per connettersi ad altre API Google Cloud all'interno di un flusso di lavoro e per integrare i 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 le chiamate ai servizi perché gestiscono la formattazione delle richieste, fornendo metodi e argomenti in modo da non dover conoscere i dettagli di un'API Google Cloud.

I connettori hanno un comportamento integrato per gestire i nuovi tentativi e le operazioni 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 Concedere un'autorizzazione dei flussi di lavoro per accedere alle risorse Google Cloud.

Nuovi tentativi

Tutti i connettori applicano le seguenti configurazioni di criteri per i nuovi tentativi e di gestione degli errori:

  • Workflows utilizza un criterio di ripetizione idempotente per le richieste GET.

  • Workflows utilizza un criterio di ripetizione non idempotente per tutti gli altri metodi HTTP.

  • Per impostazione predefinita, le richieste scadono dopo 30 minuti. Tieni presente che per le operazioni a lunga esecuzione, questo vale per le singole richieste (ad esempio l'avvio dell'operazione o il controllo del relativo stato) all'interno dell'operazione a lunga esecuzione. Il tempo di attesa per l'intera operazione può essere configurato utilizzando il campo connector_params. Consulta la documentazione di riferimento dei connettori.

Operazioni a lunga esecuzione

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

  • Workflows bloccano l'esecuzione del workflow finché l'operazione non viene completata correttamente o non va a buon fine.

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

  • I connettori eseguono il polling delle operazioni a lunga esecuzione periodicamente. Per impostazione predefinita, Workflows utilizza un backoff esponenziale di 1,25 durante l'esecuzione di poll, iniziando con 1 secondo e rallentando fino a 60 secondi tra un poll 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 dei 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 unoperazione a lunga esecuzione, Workflows solleva un errore OperationError. L'errore include un attributo aggiuntivo, error, che contiene dettagli specifici per l'operazione.

Se unoperazione a lunga esecuzione 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 la sezione Guida di riferimento dei connettori.

Passaggi successivi