Caricare e scaricare 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 caricare direttamente in un altro progetto di integrazione senza alcuna modifica. 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 fatica.
  • Puoi aggiornare in modo programmatico il file di integrazione in caso di modifiche ripetitive, come la ridenominazione di attività o la modifica dinamica dei nomi delle variabili.

Scaricare un'integrazione

Per scaricare un'integrazione, segui questi passaggi:

  1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppo > Integrazioni.
  3. Seleziona un'integrazione esistente. L'integrazione si apre nell'editor di integrazione.
  4. Fai clic sul menu a discesa Versioni e seleziona la versione da scaricare.
  5. 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 tuo browser web.

Carica un'integrazione

Per caricare un'integrazione, segui questi passaggi:

  1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppo > 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.
    3. Fai clic su Crea.

    L'integrazione si apre nell'editor di integrazione.

  4. Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Carica.
  5. Nella finestra di dialogo del browser di file, seleziona il file da caricare, quindi fai clic su Apri.

    Viene creata una nuova versione dell'integrazione utilizzando il file caricato.

Download e caricamento tramite API

Puoi utilizzare le API di integrazione per caricare o scaricare un'integrazione.

Scarica l'integrazione utilizzando l'API

Per scaricare un'integrazione, invia una richiesta GET alla seguente API:
https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/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/products/apigee/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

Per saperne di più, visita projects.locations.products.integrations.versions.download.

Carica integrazione tramite API

Per caricare un'integrazione, invia una richiesta POST alla seguente API:
  https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/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/products/apigee/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/apigee-1/locations/us-east1/products/apigee/integrations/test-integration/versions:upload

Per maggiori informazioni sull'API, consulta projects.locations.products.integrations.versions.upload.

Considerazioni

Quando utilizzi la funzione di caricamento o download, tieni presente quanto segue:

  • Il caricamento di un'integrazione crea una nuova versione dell'integrazione. Ad esempio, se hai un'integrazione denominata IP-Test alla versione 5 e carichi un file di integrazione in IP-Test, viene creata una nuova versione 6 per l'integrazione.
  • Se non disponi di un'integrazione esistente in cui caricare un file, devi prima creare una nuova integrazione e poi caricarla. In questo caso, la nuova integrazione creata sarà alla versione 1 e l'integrazione caricata sarà alla versione 2.
  • I dettagli dei profili di autenticazione configurati per un'integrazione non saranno disponibili nel file scaricato. Dopo aver caricato il file, devi riconfigurare i profili di autenticazione nell'integrazione caricata.