上传和下载集成

您可以将集成下载为 JSON 文件并将其保存到本地系统中。这样，整个集成会以文件形式提供，该文件可直接上传到另一个集成项目中，无需任何修改。上传集成会在该文件上传到的项目中创建集成的新版本。

使用文件格式的整个集成具有以下优势：

您可以轻松地将集成从一个项目复制到另一个项目。
您可以通过编程方式更新集成文件，以便进行重复性更改，例如重命名任务或动态修改变量名称。

下载集成

如需下载集成，请执行以下步骤：

在 Apigee 界面中，选择您的 Apigee 组织。
点击开发 > 集成。
选择现有集成。这将在集成编辑器中打开集成。
点击版本下拉菜单，然后选择您要下载的版本。
在设计器工具栏中，点击（操作菜单），然后选择下载。
INTEGRATION_NAME.json 文件会自动保存到网络浏览器的默认下载文件夹中。

注意：下载的 JSON 文件的结构为 DownloadIntegrationVersionResponse 类型。如果您修改 JSON 文件，请确保修改后的文件符合 DownloadIntegrationVersionResponse 结构。

上传集成

如需上传集成，请执行以下步骤：

在 Apigee 界面中，选择您的 Apigee 组织。
点击开发 > 集成。
选择现有集成，或点击创建集成以创建新的集成。
要创建新的集成，请执行以下操作：
1. 在创建 Integrations对话框中输入名称和说明。
2. 选择集成的区域。
  注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
3. 点击创建。
这将在集成编辑器中打开集成。
在设计器工具栏中，点击（操作菜单），然后选择上传。
在文件浏览器对话框中，选择要上传的文件，然后点击打开。
系统会使用上传的文件创建新版本的集成。

使用 API 下载和上传

您可以使用 integration API 来上传或下载集成。

使用 API 下载集成

如需下载集成，请向以下 API 发出 GET 请求：

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

以下示例展示了如何下载集成的特定版本：

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"

注意：在前面的示例中，集成版本号为 0e90d453-5fcf-4aae-b164-2e8344d1ac11。如需获取集成版本，请在界面中打开所需的集成版本，然后复制从网址自动生成的唯一 ID 字符串中 ../integrations/integration/INTEGRATION_NAME/ 之后的部分。

如需了解详情，请参阅 projects.locations.products.integrations.versions.download。

使用 API 上传集成

如需上传集成，请向以下 API 发出 POST 请求：

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

以下示例展示了如何上传集成：

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

如需详细了解此 API，请参阅 projects.locations.products.integrations.versions.upload。

注意事项

使用上传或下载功能时，请考虑以下几点：

上传集成会创建集成的新版本。例如，如果您在版本 5 中有一个名为 IP-Test 的集成，并且您在 IP-Test 中上传集成文件，则系统会为集成创建新的版本 6。
如果您还没有可以在其中上传文件的集成，则必须先创建新的集成，然后上传。在这种情况下，您创建的新集成位于版本 1 中，上传的集成位于版本 2 中。
下载文件中不会提供为集成配置的身份验证配置文件的详细信息。上传文件后，您必须在上传的集成中重新配置身份验证配置文件。