Sospensione attività

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

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

Scadenza del tempo 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à di sospensione e impostarlo su qualsiasi valore e utilizzarlo per creare condizioni di diramazione per l'esecuzione delle attività downstream.

Confrontare l'attività Approvazione, l'attività Sospendi e l'attività 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 alcune differenze minime tra loro. La tabella seguente descrive le differenze tra le tre attività.

Attività approvazione	Sospensione attività	Attività timer
Non supporta la ripresa automatica di un'integrazione e richiede un intervento manuale per riprendere l'integrazione.	Supporta la ripresa sia manuale che automatica di un'integrazione. In caso contrario, un intervento manuale per revocare la sospensione, l'integrazione di riprendere 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 al termine del limite di tempo per la sospensione.
Impossibile riprendere un'integrazione tramite una chiamata API. Devi risolvere manualmente la sospensione utilizzando l'interfaccia utente di Integrations.	Può riprendere un'integrazione utilizzando l'API `Suspensions` per le integrazioni.	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 notifiche quando un'integrazione viene messa in pausa (sospesa).
Supporta una variabile di output (booleano), 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 le variabili di output.

Configura l'attività di sospensione

Per configurare l'attività di sospensione, segui questi passaggi:

Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.
Vai ad Application Integration
Nel menu di navigazione, fai clic su Integrations (Integrazioni).
Viene visualizzata la pagina Integrazioni, in cui sono elencate tutte le integrazioni disponibili nel progetto Google Cloud.
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.
  Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
  Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai attivato la governance dell'integrazione per la regione selezionata.
4. Fai clic su Crea.
Viene visualizzata l'integrazione nell'editor di integrazione.
Nella barra di navigazione dell'editor dell'integrazione, fai clic su Attività per visualizzare l'elenco delle attività e dei connettori disponibili.
Fai clic e posiziona l'elemento dell'attività Sospendi nell'editor di integrazione.
Fai clic sull'elemento attività Sospendi nel designer per visualizzare l'attività Sospendi di configurazione del deployment.
Configura i campi rimanenti utilizzando le Proprietà di configurazione per l'attività come indicato nelle tabelle di seguito.
Tutte le modifiche alle proprietà vengono salvate automaticamente.

Proprietà di configurazione

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

Proprietà	Tipo di dati	Descrizione
`Suspension Time`	Numero intero	Tempo (in minuti) fino al quale l'esecuzione dell'integrazione deve essere sospesa. Il valore massimo il limite di tempo è 44640 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à di sospensione. L'impostazione del valore per questa variabile è facoltativa. Puoi impostare questa variabile su qualsiasi valore in base a requisito. 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 basate sul valore di 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 recuperare il valore dell'identificatore dalla pagina dei log di esecuzione nell'interfaccia utente dell'integrazione. Se utilizzi un'API per il trigger, puoi anche ottenere il valore dell'identificatore dall'oggetto di risposta di un'API l'integrazione. Puoi riprendere l'esecuzione dell'integrazione utilizzando l'ID sospensione o l'ID esecuzione dell'integrazione.

Revocare 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 Suspensions, 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, il campo INTEGRATION_ID è facoltativo. Tuttavia, devi fornire EXECUTION_ID o SUSPENSION_ID. Se non hai 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à a valle dopo l'attività di sospensione.

Gli esempi riportati di seguito mostrano come revocare una sospensione utilizzando l'API suspensions.

Esempio 1: revocare una sospensione utilizzando solo 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: revocare 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: revocare una sospensione con l'ID esecuzione e l'ID sospensione

Il seguente comando curl mostra come revocare una sospensione se sono presenti sia l'ID esecuzione che 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 sui 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

Scopri di più su tutte le attività e gli attivatori.
Scopri come testare e pubblicare un'integrazione .

Scopri di più sulla gestione degli errori.
Scopri di più sui log di esecuzione dell'integrazione.