“调用集成”任务

借助调用集成任务，您可以调用在 Google Cloud 项目中创建的其他集成。

当您需要定义多个使用主集成（父级集成）控制的小型集成（子集成）时，调用集成任务非常有用。运行子集成后，您还可以读取主集成中的子集成响应。

准备工作

  • 调用集成任务使用 API 触发器来识别和调用其他集成和子集成。因此，您必须确保使用 API 触发器配置要调用的集成。如需了解如何配置 API 触发器，请参阅 API 触发器。
  • 确保您已将用户管理的服务账号关联到您的集成。如果您的集成未配置用户管理的服务账号，则默认情况下使用默认服务账号 (service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) 进行身份验证。
  • 确保您的服务账号具有 Application Integration Invoker IAM 角色。如需了解如何向服务账号授予角色，请参阅管理对服务账号的访问权限。

配置调用集成任务

要配置调动集成任务，请执行以下操作：

  1. 在 Apigee 界面中，选择您的 Apigee 组织。
  2. 点击开发 > 集成。
  3. 选择现有集成，或通过点击创建集成来创建新集成。

    要创建新的集成，请执行以下操作：

    1. 在创建 Integrations对话框中输入名称和说明。
    2. 从支持的区域列表中选择集成的区域。
    3. 点击创建。

    这将在集成设计器中打开集成。

  4. 在集成设计器导航栏中，点击 + 添加任务/触发器 > 任务以查看可用任务列表。
  5. 点击调用集成元素，并将其放入集成编辑器中。
  6. 点击设计器上的调用集成任务元素以查看调用集成任务配置窗格。
  7. 配置以下子集成详细信息：
    1. API 触发器 ID：输入要调用的集成的 API 触发器 ID。您可以调用单个集成 ID 或多个具有相同触发器 ID 的集成。
    2. 运行使用此 API 触发器 ID 的所有集成：选择此选项可调用具有相同 API 触发器 ID 的所有集成。

      例如，如果集成 A 和集成 B 具有相同 API 触发器 ID，将同时运行集成 A 和 B。

    3. 运行单个集成：选择此选项可仅调用集成名称字段中指定的集成。您可以通过配置映射子集成响应变量中详细介绍的字段来访问和映射子集成的响应。

    4. 执行策略：选择要调用的子集成的执行模式。
      • SYNC：在同步模式下运行子集成。在此模式下，主集成会等待子集成完成，然后再继续执行下游任务。

      • ASYNC：以异步模式运行子集成。在此模式下，主集成不会等待子集成完成。在调用子集成后，主集成会立即运行下游任务。

        如果选择此选项，请设置执行延迟时间（以毫秒为单位）。设置后，它会指定运行集成之前的延迟时间。

      系统会自动保存对属性的所有更改。

映射子集成响应变量

下表介绍了用于在主集成和子集成之间映射变量的配置属性：
属性 说明
Map to sub-integration input(s)

将主集成中的值映射到子集成。此字段采用键值对形式的值，其中键是主集成中的一个变量，值是子集成中的相应输入变量。

例如，如果要将主集成的 productID 变量映射到 subIntProductID 子集成变量，请从从中映射的集成变量字段中选择 productID，然后在要映射到的子集成输入字段中输入 subIntProductID。
Map values to sub-integration output(s) 将子集成输出变量映射到主集成变量中。

点击要从中映射的子集成输出，然后选择子集成。点击要映射到的集成变量，然后选择相应的主集成变量。

最佳做法

如需了解适用于调用集成任务的用量限额，请参阅用量限额。

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略，以及了解不同类型的错误处理策略，请参阅错误处理策略。