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:
- Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
- Fai clic su Sviluppo > Integrazioni.
- Seleziona un'integrazione esistente. L'integrazione si apre 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
Il file INTEGRATION_NAME.json viene salvato automaticamente nella cartella dei download predefinita del tuo browser web.
(menu Azioni) e seleziona Scarica.
Carica un'integrazione
Per caricare un'integrazione, segui questi passaggi:
- Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
- Fai clic su Sviluppo > Integrazioni.
- Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
- Seleziona una regione per l'integrazione.
- Fai clic su Crea.
L'integrazione si apre 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 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 richiestaGET
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 richiestaPOST
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.