Subir y descargar integraciones

Puedes descargar tus integraciones como un archivo JSON y guardarlas en tu sistema local. Como resultado, toda tu integración está disponible en un archivo, que puedes subir directamente en otro proyecto de integración sin modificaciones. Si subes una integración, se crea una versión nueva de la integración en el proyecto en el que se sube el archivo.

Tener una integración completa en un formato de archivo te brinda las siguientes ventajas:

Puedes copiar tu integración de un proyecto a otro sin mucho esfuerzo.
Puedes actualizar el archivo de integración de manera programática para realizar cambios repetitivos, como el cambio de nombre de las tareas o la modificación dinámica de los nombres de variables.

Descarga una integración

Para descargar una integración, sigue estos pasos:

En la IU de Apigee, selecciona tu organización de Apigee.
Haz clic en Desarrollar > Integraciones.
Selecciona una integración existente. Esto abrirá la integración en la página del editor de integración.
Haz clic en el menú desplegable Versiones y selecciona la versión que deseas descargar.
En la barra de herramientas del diseñador, haz clic en (menú de acciones) y selecciona Download.
El archivo .json INTEGRATION_NAME se guarda automáticamente en la carpeta de descarga predeterminada del navegador web.

Nota: El archivo JSON descargado tendrá la estructura del tipo DownloadIntegrationVersionResponse. Si modificas el archivo JSON, asegúrate de que cumpla con la estructura de DownloadIntegrationVersionResponse.

Sube una integración

Para subir una integración, realiza los siguientes pasos:

En la IU de Apigee, selecciona tu organización de Apigee.
Haz clic en Desarrollar > Integraciones.
Selecciona una integración existente o crea una nueva haciendo clic en Crear integración.
Si creas una integración nueva, haz lo siguiente:
1. Ingresa un nombre y una descripción en el diálogo Crear integración.
2. Selecciona una región para la integración.
  Nota: En el menú desplegable Regiones, solo se enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
3. Haz clic en Crear.
Esto abrirá la integración en la página del editor de integración.
En la barra de herramientas del diseñador, haz clic en (menú de acciones) y selecciona Subir.
En el cuadro de diálogo del navegador de archivos, selecciona el archivo que deseas subir y haz clic en Abrir.
Se crea una versión nueva de la integración mediante el archivo subido.

Descarga y sube mediante la API

Puedes usar las API de integración para subir o descargar una integración.

Descarga la integración mediante la API

Para descargar una integración, envía una solicitud GET a la siguiente API:

https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

En el siguiente ejemplo, se muestra cómo descargar una versión específica de una integración:

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: En el ejemplo anterior, el número de versión de integración es 0e90d453-5fcf-4aae-b164-2e8344d1ac11. Para obtener la versión de integración, abre la versión requerida de la integración en la IU y copia la string de ID única generada de forma automática después de ../integrations/integration/INTEGRATION_NAME/ desde la URL.

Para obtener más información, consulta projects.locations.products.integrations.versions.download.

Sube una integración mediante la API

Para subir una integración, envía una solicitud POST a la siguiente API:

  https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}:upload

En el siguiente ejemplo, se muestra cómo subir una integración:

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

Para obtener más información sobre la API, consulta projects.locations.products.integrations.versions.upload.

Consideraciones

Cuando uses la función de carga o descarga, ten en cuenta los siguientes puntos:

Cuando se sube una integración, se crea una versión nueva de la integración. Por ejemplo, si tienes una integración llamada IP-Test en la versión 5 y subes un archivo de integración en IP-Test, se creará una nueva versión 6 para la integración.
Si no tienes una integración existente en la que puedas subir un archivo, primero debes crear una integración nueva y, luego, subirla. En este caso, la integración nueva que crees estará en la versión 1 y la integración subida será en la versión 2.
Los detalles de los perfiles de autenticación configurados para una integración no estarán disponibles en el archivo descargado. Después de subir el archivo, debes volver a configurar los perfiles de autenticación en la integración subida.