计时器任务

您可以使用计时器任务向集成执行流程添加时间延迟。

在集成执行期间，当控制项到达计时器任务时，系统会将执行暂停指定的时长，并且计时器任务后面的所有任务都将暂停。此任务仅支持自动恢复集成。集成执行会在暂停时间限制到期后自动恢复。例如，如果将计时器任务设置为 180 秒，则执行会暂停 3 分钟，然后自动恢复。

比较审批任务、暂停任务和计时器任务

所有三个（审批、暂停和计时器）任务都执行类似的集成暂停和恢复功能。但它们之间存在细微差异。下表介绍了三个任务之间的差异。

审批任务 暂停任务 计时器任务
不支持自动恢复集成，需要人工干预来恢复集成。 支持手动和自动恢复集成。如果没有人工干预来撤消暂停，则集成会在暂停时间限制到期后自动恢复执行。 仅支持自动恢复集成。集成执行会在暂停时间限制到期后自动恢复。
无法通过 API 调用恢复集成。您必须使用集成界面手动解决暂停。 可以使用适用于集成的 Suspensions API 来恢复集成。 仅支持自动恢复集成。
集成暂停（已暂停）时，用户会收到通知。 集成暂停（已暂停）时，用户不会收到任何通知。 集成暂停（已暂停）时，用户不会收到任何通知。
支持输出变量（布尔值），可让您在恢复集成之前执行条件检查。但是，输出变量的值只能为 true 或 false。 支持输出变量（字符串），可让您在恢复集成之前执行条件检查。您可以为输出变量设置任何值。 不支持任何输出变量。

配置计时器任务

要配置计时器任务，请执行以下操作：

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

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

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

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

  4. 在集成设计器导航栏中，点击 + 添加任务/触发器 > 任务以查看可用任务列表。
  5. 点击计时器任务元素，并将其放入集成编辑器中。
  6. 点击设计器上的计时器任务元素以查看计时器任务配置窗格。
  7. 使用任务的配置属性配置其余字段。 例如，如果您将超时设置为 180，将时间单位设置为 Seconds，则执行会暂停 3 分钟，然后再自动恢复。
  8. 系统会自动保存对属性的更改。

配置属性

下表介绍了计时器任务的配置属性。

属性 数据类型 说明
Timeout after 整数

必须将集成执行暂停的时长。时间限制到期后，集成会自动继续执行下一个下游任务。

默认值：120 秒（2 分钟）。

允许的最长时间限制：44640 分钟（31 天）。
Time unit 秒、分钟、小时、天 超时期限属性的时间单位。

错误处理策略

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