Importer et télécharger des intégrations

Vous pouvez télécharger vos intégrations sous forme de fichier JSON et l'enregistrer dans votre système local. De ce fait, une intégration est disponible dans un fichier que vous pouvez importer directement dans un autre projet d'intégration sans aucune modification. L'importation d'une intégration crée une nouvelle version de l'intégration dans le projet dans lequel le fichier est importé.

L'intégration complète dans un format de fichier vous offre les avantages suivants :
  • Vous pouvez copier votre intégration d'un projet à un autre sans effort.
  • Vous pouvez mettre à jour par programmation le fichier d'intégration pour les modifications répétitives, telles que le changement de nom des tâches ou la modification dynamique des noms de variables.

Télécharger une intégration

Pour télécharger une intégration, procédez comme suit :

  1. Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
  2. Cliquez sur Développer > Intégrations.
  3. Sélectionnez une intégration existante. Cela entraîne son ouverture dans l'éditeur d'intégrations.
  4. Cliquez sur la liste déroulante Versions et sélectionnez la version que vous souhaitez télécharger.
  5. Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Télécharger.

    Le fichier INTEGRATION_NAME.json est automatiquement enregistré dans le dossier de téléchargement par défaut de votre navigateur Web.

Importer une intégration

Pour importer une intégration, procédez comme suit :

  1. Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
  2. Cliquez sur Développer > Intégrations.
  3. Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.

    Si vous créez une intégration :

    1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
    2. Sélectionnez une région pour l'intégration.
    3. Cliquez sur Créer.

    Cela entraîne l'ouverture de l'intégration dans l'éditeur d'intégrations.

  4. Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Importer.
  5. Dans la boîte de dialogue de l'explorateur de fichiers, sélectionnez le fichier que vous souhaitez importer, puis cliquez sur Ouvrir.

    Une nouvelle version de l'intégration est créée à l'aide du fichier importé.

Télécharger et importer à l'aide de l'API

Vous pouvez importer ou télécharger une intégration à l'aide des API d'intégration.

Télécharger l'intégration à l'aide de l'API

Pour télécharger une intégration, envoyez une requête GET à l'API suivante : 
https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

L'exemple suivant montre comment télécharger une version spécifique d'une intégration :

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"

Pour en savoir plus, consultez la page projects.locations.products.integrations.versions.download.

Importer une intégration à l'aide de l'API

Pour importer une intégration, envoyez une requête POST à l'API suivante :
  https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}:upload

L'exemple suivant montre comment importer une intégration :

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

Pour en savoir plus sur l'API, consultez la page projects.locations.products.integrations.versions.upload.

Points à prendre en compte

Lorsque vous utilisez la fonctionnalité d'importation ou de téléchargement, tenez compte des points suivants :

  • L'importation d'une intégration crée une nouvelle version de l'intégration. Par exemple, si vous avez une intégration nommée IP-Test à la version 5 et que vous importez un fichier d'intégration dans IP-Test, une nouvelle version 6 est créée pour cette intégration.
  • Si vous ne disposez pas déjà d'une intégration dans laquelle vous pouvez importer un fichier, vous devez d'abord créer une nouvelle intégration, puis importer le fichier. Dans ce cas, la nouvelle intégration que vous créez sera dans la version 1 et l'intégration importée dans la version 2.
  • Les détails des profils d'authentification configurés pour une intégration ne seront pas disponibles dans le fichier téléchargé. Après avoir importé le fichier, vous devez reconfigurer les profils d'authentification dans l'intégration importée.