Questa pagina è stata tradotta dall'API Cloud Translation.

Caricare e scaricare integrazioni

Puoi scaricare le integrazioni come file JSON e salvarle nel nel tuo sistema locale. Di conseguenza, l'intera integrazione è disponibile in un file, che puoi eseguire direttamente caricarli in un altro progetto di integrazione senza apportare alcuna modifica. Il caricamento di un'integrazione 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 sforzi.
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:

Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
Fai clic su Sviluppo > Integrazioni.
Seleziona un'integrazione esistente. L'integrazione viene aperta nell'editor dell'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 tuo browser web.

Nota: il file JSON scaricato avrà la struttura di DownloadIntegrationVersionResponse di testo. Se modifichi il file JSON, assicurati che il file modificato rispetti le DownloadIntegrationVersionResponse della tua struttura.

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:
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 saperne di più, consulta Attivare una nuova regione.
3. Fai clic su Crea.
L'integrazione viene aperta nell'editor dell'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.

Download e caricamento tramite API

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

Scarica integrazione tramite API

Per scaricare un'integrazione, invia una richiesta GET all'API seguente:

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"

Nota: nell'esempio precedente, il numero di versione dell'integrazione è 0e90d453-5fcf-4aae-b164-2e8344d1ac11. Per ottenere la versione dell'integrazione, apri il 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.products.integrations.versions.download.

Carica integrazione tramite API

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

  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 ulteriori 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 disponi un'integrazione denominata IP-Test alla versione 5 e caricate 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 quindi carica il video. In questo caso, la nuova integrazione creata sarà nella versione 1 e quella caricata sarà alla versione 2.
I dettagli dei profili di autenticazione configurati per un'integrazione non saranno disponibili in scaricato il file. Dopo aver caricato il file, devi riconfigurare i profili di autenticazione in l'integrazione caricata.