Caricare e scaricare le integrazioni

Puoi scaricare le integrazioni come file JSON e salvarlo 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.

L'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 per 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'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppa > Integrazioni.
  3. Seleziona un'integrazione esistente. L'integrazione viene aperta 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 browser web.

Carica un'integrazione

Per caricare un'integrazione, 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.
    3. Fai clic su Crea.

    L'integrazione viene aperta 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 che vuoi 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 ulteriori informazioni, vedi projects.locations.products.integrations.versions.download.

Carica integrazione utilizzando l'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 caricarlo. 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.