Informazioni sui connettori

Workflows pubblica i connettori per semplificare l'accesso ad altri Google Cloud prodotti all'interno di un workflow. Per un riferimento dettagliato dei connettori disponibili, consulta il riferimento ai connettori.

I connettori possono essere utilizzati per connettersi ad altre Google Cloud API all'interno di un workflow e per integrare i workflow con questi Google Cloud prodotti. 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 per te, fornendo metodi e argomenti in modo che tu non debba conoscere i dettagli di un' Google Cloud API.

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

Autenticazione

I connettori utilizzano l'autenticazione Identity and Access Management integrata per interagire con altri Google Cloud prodotti. Tieni presente che un workflow che utilizza un connettore deve comunque disporre delle autorizzazioni appropriate assegnate al relativo account di servizio per eseguire correttamente l'autenticazione a una determinata API. Ad esempio, per pubblicare un messaggio in Pub/Sub, al account di servizio associato al workflow deve essere concesso il ruolo roles/pubsub.publisher. Per saperne di più sull'autenticazione ad altri Google Cloud prodotti, consulta Concedi l'autorizzazione dei workflow per l'accesso alle Google Cloud risorse.

Nuovi tentativi

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

  • Workflows utilizza un criterio per i nuovi tentativi idempotente per le richieste GET.

  • Workflows utilizza un criterio per i nuovi tentativi non idempotente per tutti gli altri metodi HTTP.

  • Per impostazione predefinita, le richieste vanno in timeout dopo 30 minuti. Tieni presente che, per le operazioni a lunga esecuzione, questo si applica alle singole richieste (ad esempio, l'avvio dell'operazione o il controllo del relativo stato) all'interno dell'operazione a lunga esecuzione. Il timeout per l'intera operazione può essere configurato utilizzando il campo connector_params. Consulta il riferimento ai connettori.

Operazioni a lunga esecuzione

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

  • Workflows blocca l'esecuzione del workflow finché l'operazione non viene completata correttamente o non va in errore.

  • 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 periodicamente il polling delle risorse LRO. Per impostazione predefinita, Workflows utilizza un backoff esponenziale di 1,25 durante il polling, a partire da 1 secondo e rallentando fino a 60 secondi tra i polling. Ogni tentativo di polling viene conteggiato come un passaggio fatturabile. I parametri di polling possono essere modificati utilizzando il campo connector_params. Per un elenco dei tipi di risorse LRO supportati, consulta il riferimento ai connettori.

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

  • Le risposte di polling vengono controllate e, se il payload della 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, che contiene dettagli specifici dell'operazione.

Se un'operazione 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.

Passaggi successivi