Sospensione attività

Annuncio: Application Integration è ora disponibile per il tuo progetto Google Cloud. Ora puoi utilizzare sia Apigee Integration che Application Integration all'interno dello stesso progetto Google Cloud. Scopri di più

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

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

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

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

Confronta l'attività di approvazione, l'attività Sospendi e l'attività Timer

Tutte e tre le attività (Approvazione, Sospensione e Timer) svolgono una funzione simile, ossia mettere in pausa e ripristinare un'integrazione. Tuttavia, ci sono lievi differenze. 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 riprenderla.	Supporta la ripresa sia manuale che automatica di un'integrazione. Se non è previsto 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 lo scadere del limite di tempo di sospensione.
Impossibile riprendere un'integrazione tramite una chiamata API. Devi risolvere manualmente la sospensione utilizzando l'interfaccia utente di integrazioni.	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 alcuna notifica quando un'integrazione viene messa in pausa (sospesa).
Supporta una variabile di output (booleana), che ti consente di eseguire controlli condizionali prima di ripristinare un'integrazione. Tuttavia, la variabile di output può avere solo il valore come true o false.	Supporta una variabile di output (stringa), che ti consente di eseguire controlli condizionali prima di ripristinare un'integrazione. Puoi impostare qualsiasi valore sulla variabile di output.	Non supporta alcuna variabile di output.

Configura l'attività di sospensione

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

1. Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
2. Fai clic su Sviluppa > Integrazioni.
3. Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
   2. Seleziona una regione per l'integrazione dall'elenco delle regioni supportate.
   3. Fai clic su Crea.

   In questo modo viene aperta l'integrazione nel designer dell'integrazione.

4. Nella barra di navigazione del designer dell'integrazione, fai clic su +Aggiungi un'attività/un trigger > Tasks per visualizzare l'elenco delle attività disponibili.
5. Fai clic sull'elemento dell'attività Sospendi nell'editor di integrazione e posizionalo.
6. Fai clic sull'elemento dell'attività Sospendi nel designer per visualizzare il riquadro di configurazione delle attività Sospendi.
7. Configura i campi rimanenti utilizzando le proprietà di configurazione per l'attività, come descritto nelle tabelle seguenti.

   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	Description
Suspension Time	Numero intero	Tempo (in minuti) fino al quale deve essere sospesa l'esecuzione dell'integrazione. Il limite di tempo massimo è di 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 su 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 della tua integrazione. Ad esempio, puoi leggere il risultato della sospensione e configurare decisioni condizionali in base al valore in qualsiasi attività downstream.
Suspension Id	Stringa	Un identificatore univoco dell'attività di sospensione. Il valore di questa variabile viene impostato subito dopo la sospensione dell'integrazione. Puoi ottenere il valore dell'identificatore dalla pagina dei log di esecuzione nell'interfaccia utente di integrazione. Puoi anche ottenere il valore dell'identificatore per ottenere il valore dell'identificatore dall'oggetto 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.

Revocare una sospensione con l'API Suspensions

L'API Suspensions consente di revocare una sospensione tramite una chiamata API. Per revocare una sospensione con l'API Suspensions, devi avere l'ID esecuzione dell'integrazione o l'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 disponi di alcun valore ID, puoi sostituire il valore con -. In questa API, i campi REGION, PROJECT e LOCATION sono obbligatori.

Nota:

• Se non specifichi sia l'ID esecuzione sia l'ID sospensione, l'API non viene eseguita e segnala un errore.
• Se non specifichi suspension_result, il valore del risultato della sospensione è impostato su Resolved.

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

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

Esempio 1: revocare una sospensione solo con 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/products/apigee/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 se 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/products/apigee/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 sia con l'ID esecuzione sia con l'ID sospensione

Il seguente comando curl mostra come revocare una sospensione se 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/products/apigee/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 riesce 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.