时间表触发器

借助时间表触发器,您可以按特定的时间间隔定期运行集成。如果您希望在不进行任何手动干预的情况下自动运行集成,则此触发器很有用。例如,您可以考虑使用时间表触发器来执行以下类型的任务:

  • 定期将文件从一个系统上传到另一个系统
  • 发送定期电子邮件提醒
  • 定期同步数据库

准备工作

请确保将 Apigee Integration Invoker IAM 角色分配给 Google Cloud 项目中的 Apigee Service Agent ( service-PROJECT_ID @gcp-sa-apigee.iam.gserviceaccount.com )。

如需详细了解如何分配 IAM 角色,请参阅在 Google Cloud 中管理访问权限

添加时间表触发器

如需向新的或现有的集成添加时间表触发器,请执行以下步骤:
  1. Apigee 界面中,选择您的 Apigee 组织
  2. 点击开发 > 集成
  3. 选择现有集成,或通过点击创建集成来创建新集成。

    要创建新的集成,请执行以下操作:

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

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

  4. 集成设计器导航栏中,点击 + 添加任务/触发器 > 触发器以查看可用触发器列表。
  5. 点击时间表触发器元素并将其放入设计器中。

配置时间表触发器

点击集成编辑器中的时间表触发器 (Schedule Trigger) 元素以查看触发器配置窗格。

您可以使用以下任一模式配置时间表触发器

  • 基本:提供用于配置运行频率的界面。
  • 高级:使用 cron 表达式配置运行频率。

基本模式下,您可以选择在特定时间或按每小时间隔运行集成。如果要在特定时间运行集成,请从时间下拉列表中选择 Run at a specific time,并设置以下属性:

  • 时间:集成必须运行的时间(采用 24 小时制)。
  • :必须运行集成的日期。您可以选择在每天、一周中的特定几天、一个月中的特定某一天等运行集成。
  • 月份:必须运行集成的月份。您可以选择每月或在特定月份运行集成。

高级模式下,您可以使用 cron 表达式指定运行频率。cron 表达式包含五个必须按以下顺序指定的值:

  • 分钟 (0-59)
  • 小时 (0-23)
  • 日期 (1-31)
  • 月份,以下任一值:
    • 1-12 的数字
    • 三个字母的月份缩写(例如 Jan、Feb、Mar 等)
  • 星期几,以下任一值:
    • 0 到 6 的数字,星期日是 0
    • 三个字母的缩写(例如 Mon、Tue、Wed 等)

例如,如需在每月的第一天运行集成,请使用 * * 1 * * cron 表达式。

最佳做法

最佳做法是不再需要时停用时间表触发器。如果让冗余时间表触发器保持活跃状态,它将继续自动触发集成。

如需停用时间表触发器,您可以执行以下任一操作:

  • 取消发布包含时间表触发器的集成。您的集成将不再有效,并且触发器也不会运行。
  • 时间表触发器替换为其他触发器,然后重新发布集成。重新发布的活跃集成版本将不使用时间表触发器
  • 删除当前版本的集成。您可以在集成名称旁边的版本列表下找到删除选项。