Carica e scarica le integrazioni

Puoi scaricare le integrazioni come file JSON e salvarle nel tuo sistema locale. Di conseguenza, l'intera integrazione è disponibile in un file, che puoi eseguire direttamente e non caricarli in un altro progetto di integrazione. Il caricamento di un'integrazione crea una nuova versione dell'integrazione nel progetto in cui viene caricato il file.

Avere un'intera integrazione in un formato file offre i seguenti vantaggi:

Puoi copiare l'integrazione da un progetto all'altro senza troppi sforzi.
Puoi aggiornare il file di integrazione in modo programmatico per le modifiche ripetitive, ad esempio la rinominazione delle attività o la modifica dinamica dei nomi delle variabili.

Scaricare un'integrazione

Per scaricare un'integrazione, seleziona una delle seguenti opzioni:

Console

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 Integrations (Integrazioni).
Seleziona un'integrazione esistente. Viene visualizzata l'integrazione nell'editor di integrazione.
Fai clic sul menu a discesa Versioni e seleziona la versione da scaricare.
Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Scarica.
Il file INTEGRATION_NAME.json viene salvato automaticamente nella cartella dei download predefinita del browser web.

Nota: il file JSON scaricato avrà la struttura del tipo DownloadIntegrationVersionResponse. Se modifichi il file JSON, assicurati che il file modificato rispetti la DownloadIntegrationVersionResponse struttura

API

Per scaricare un'integrazione, invia una richiesta GET alla seguente API: GET https://integrations.googleapis.com/v1/projects/*/locations/*/integrations/*/versions/*:download

https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

L'esempio seguente mostra come scaricare una versione specifica di un'integrazione:

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

Nota: nell'esempio precedente, il numero di versione dell'integrazione è 0e90d453-5fcf-4aae-b164-2e8344d1ac11. Per ottenere la versione dell'integrazione, apri lo strumento dell'integrazione nell'interfaccia utente e copia la stringa ID univoco generata automaticamente ../integrations/integration/INTEGRATION_NAME/ dell'URL.

Per ulteriori informazioni, vedi projects.locations.integrations.versions.download.

Caricare un'integrazione

Il caricamento di un'integrazione crea una nuova versione dell'integrazione nel progetto in cui viene caricato. Ad esempio, se disponi di un'integrazione denominata IP-Test nella versione 5 e carichi un file di integrazione in IP-Test, viene creata una nuova versione 6 per l'integrazione.

Se non hai un'integrazione esistente in cui puoi caricare un file, devi prima creare una nuova integrazione e poi caricarla. In questo caso, la nuova integrazione che crei sarà nella versione 1 e quella caricata nella versione 2.

Se hai già un'integrazione da caricare, seleziona una delle seguenti opzioni:

Console

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 Integrations (Integrazioni).
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.
  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. Fai clic su Crea.
Viene visualizzata l'integrazione nell'editor di integrazione.
Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Carica.
Nella finestra di dialogo del browser di file, seleziona il file che vuoi caricare e poi fai clic su Apri.
Viene creata una nuova versione dell'integrazione utilizzando il file caricato.

API

Per caricare un'integrazione, invia una richiesta POST alla seguente API:

  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload

L'esempio seguente mostra come caricare un'integrazione:

  curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
  -X POST -d '{"content": 
    "{\"name\":\"projects/450954726404/locations/us-east1/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
    \"origin\":\"UI\",
    \"snapshotNumber\":\"3\",
    \"updateTime\":\"2022-01-06T04:26:58.137Z\",
    \"lockHolder\":\"abc@test.com\",
    \"createTime\":\"2022-01-06T04:26:42.734Z\",
    \"lastModifierEmail\":\"abc@test.com\",
    \"state\":\"DRAFT\",
    \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
    \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' 
    \https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions:upload

Per ulteriori informazioni, vedi projects.locations.integrations.versions.upload.

Passaggi successivi

Scopri come gestire le integrazioni.
Scopri come testare e pubblicare le integrazioni.
Scopri di più su tutte le attività e gli attivatori.