Sospensione attività

L'attività Sospendi consente di mettere temporaneamente in pausa e poi riprendere l'esecuzione di un'integrazione.

Durante l'esecuzione di un'integrazione, quando il controllo raggiunge un'attività Sospendi, l'esecuzione viene interrotta e tutte le attività successive all'attività Sospendi vengono sospese. L'integrazione riprende l'esecuzione quando si verifica uno dei seguenti eventi:

  • Scadenza del periodo di sospensione specificato.
  • Dopo aver ricevuto una richiesta di ripresa dell'esecuzione dall'API Suspensions.

Puoi anche configurare una variabile di output (Risultato della sospensione) per l'attività Sospendi, impostarla su qualsiasi valore e utilizzarla per creare condizioni di diramazione per l'esecuzione delle attività downstream.

Confronta le attività di approvazione, sospensione e timer

Tutte e tre le attività (Approvazione, Sospendi e Timer) svolgono una funzione simile di messa in pausa e ripresa di un'integrazione. Tuttavia, esistono sottili differenze tra di loro. La tabella seguente descrive le differenze tra le tre attività.

Attività approvazione Sospensione attività Attività timer
Riprende quando un utente approva o rifiuta la richiesta nell'interfaccia utente di Integrations o utilizzando l'API. Supporta il ripristino manuale e automatico di un'integrazione. Se non viene eseguito alcun intervento manuale per revocare la sospensione, l'integrazione riprenderà automaticamente l'esecuzione dopo la scadenza del limite di tempo di sospensione. Supporta solo la ripresa automatica di un'integrazione. L'esecuzione dell'integrazione riprende automaticamente dopo la scadenza del limite di tempo della sospensione.
Può riprendere un'integrazione dalla UI di Integrations o chiamando il metodo suspensions.resolve. Consulta Approva o rifiuta utilizzando l'API. Può riprendere un'integrazione chiamando il metodo suspensions.lift. Supporta solo la ripresa automatica di un'integrazione.
Gli utenti ricevono una notifica quando un'integrazione viene messa in pausa (sospesa). Gli utenti non ricevono alcuna notifica quando un'integrazione viene messa in pausa (sospesa). Gli utenti non ricevono alcuna notifica quando un'integrazione viene messa in pausa (sospesa).
Supporta una variabile di output (booleana), che consente di eseguire controlli condizionali prima di riprendere un'integrazione. Tuttavia, la variabile di output può avere solo il valore true o false. Supporta una variabile di output (stringa), che consente di eseguire controlli condizionali prima di riprendere un'integrazione. Puoi impostare qualsiasi valore per la variabile di output. Non supporta variabili di output.

Configura l'attività di sospensione

Per configurare l'attività Sospendi, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Application Integration.

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrazioni.

    Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

  3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
    2. Seleziona una regione per l'integrazione.
    3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli del account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti dell'integrazione.
    4. Fai clic su Crea. L'integrazione appena creata si apre nell'editor delle integrazioni.

  4. Nella barra di navigazione dell'editor delle integrazioni, fai clic su Attività per visualizzare l'elenco delle attività e dei connettori disponibili.
  5. Fai clic e posiziona l'elemento dell'attività Sospendi nell'editor di integrazione.
  6. Fai clic sull'elemento dell'attività Sospendi nel designer per visualizzare il riquadro di configurazione dell'attività Sospendi.
  7. Configura i campi rimanenti utilizzando le proprietà di configurazione per l'attività, come descritto in dettaglio nelle tabelle riportate di seguito.

    Tutte le modifiche alle proprietà vengono salvate automaticamente.

Proprietà di configurazione

La tabella seguente descrive le proprietà di configurazione dell'attività Sospendi.

Proprietà Tipo di dati Descrizione
Suspension Time Numero intero Tempo (in minuti) fino al quale l'esecuzione dell'integrazione deve essere sospesa. Il limite di tempo massimo è di 44.640 minuti (31 giorni), che è anche il valore predefinito.

Se l'esecuzione dell'integrazione non riprende entro il limite di tempo specificato, l'integrazione riprende automaticamente l'esecuzione dopo la scadenza del limite di tempo e imposta il valore della variabile Suspension result su Expired.

Suspension result Stringa Una variabile per archiviare il risultato dell'attività Sospendi. L'impostazione del valore per questa variabile è facoltativa. Puoi impostare questa variabile su qualsiasi valore in base alle tue esigenze. Questa variabile è utile se vuoi avere un maggiore controllo sul flusso di esecuzione dell'integrazione. Ad esempio, puoi leggere il risultato della sospensione e configurare decisioni condizionali in base al valore in una qualsiasi delle tue attività downstream.
Suspension Id Stringa Un identificatore univoco per l'attività di sospensione. Il valore di questa variabile viene impostato immediatamente dopo la sospensione dell'integrazione. Puoi ottenere il valore dell'identificatore dalla pagina dei log di esecuzione nella UI di integrazione. Puoi anche ottenere il valore dell'identificatore dall'oggetto di risposta di un'API se utilizzi un'API per attivare l'integrazione.

Puoi riprendere l'esecuzione dell'integrazione utilizzando l'ID sospensione o l'ID esecuzione dell'integrazione.

Revoca una sospensione con l'API Suspensions

L'API Suspensions ti consente di revocare una sospensione tramite una chiamata API. Per revocare una sospensione con l'API Sospensioni, devi disporre dell'ID esecuzione dell'integrazione o dell'ID sospensione dell'attività Sospendi. Per revocare una sospensione, devi inviare una richiesta POST alla seguente API:

https://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift

In questa API, INTEGRATION_ID è facoltativo. Tuttavia, devi fornire EXECUTION_ID o SUSPENSION_ID. Se non disponi di nessuno dei valori ID, puoi sostituire il valore con -. In questa API, REGION, PROJECT e LOCATION sono campi obbligatori.

Dopo aver revocato la sospensione, l'esecuzione dell'integrazione riprende ed esegue le attività downstream dopo l'attività Sospendi.

I seguenti esempi mostrano come revocare una sospensione utilizzando l'API suspensions.

Esempio 1: revoca di una sospensione solo con l'ID sospensione

Il seguente comando curl mostra come revocare una sospensione quando hai solo l'ID sospensione:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"Approved"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift

In questo esempio, la variabile Suspension result è impostata su Approved per l'ID sospensione c6a13a79-a918-41e2-82b9-32b5a010755a.

Esempio 2: revoca una sospensione solo con l'ID esecuzione

Il seguente comando curl mostra come revocare una sospensione quando hai solo l'ID esecuzione:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"true"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift

In questo esempio, la variabile Suspension result è impostata su true per l'ID esecuzione 76a391e7-c801-45d7-8046-eab20d167ec5.

Esempio 3: revoca una sospensione con l'ID esecuzione e l'ID sospensione

Il seguente comando curl mostra come revocare una sospensione quando hai sia l'ID esecuzione sia l'ID sospensione:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"{processname: "Release", owner: "John", status: "approved"};"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift

In questo esempio, la variabile Suspension result è impostata su {processname: "Release", owner: "John", status: "approved"}; per l'ID sospensione f01815bf-ed18-4e01-9d41-cc2ce7861e95.

Strategia di gestione degli errori

Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere se l'attività non va a buon fine a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e per conoscere i diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi