查看 Application Integration 支援的連接器。

Cloud Scheduler 觸發條件

Cloud Scheduler 觸發事件可讓您在多個區域中，依指定時間間隔或定期執行整合作業。

Cloud Scheduler 觸發事件 可利用 Cloud Scheduler 服務，在應用程式整合中提供全代管的企業級 Cron 工作排程器。有了這個觸發條件，您現在可以透過應用程式整合使用者介面和 Cloud Scheduler 資訊主頁，管理整合作業中建立的所有 Cron 工作。此外，Cloud Scheduler 觸發事件也能讓您部署跨區域的 Cron 工作，以便排定整合執行作業。

舉例來說，如果您已在 us-central1 中佈建整合，可以使用 Cloud Scheduler 觸發事件在 asia-east1 (或 Cloud Scheduler 支援的任何 Google Cloud 區域) 中部署 Cron 工作，以便在 us-central1 中呼叫整合的端點。

事前準備

請務必先在 Google Cloud 專案中執行下列工作，再設定 Cloud Scheduler 觸發事件：

  1. 啟用 Cloud Scheduler API (cloudscheduler.googleapis.com)。

    啟用 Cloud Scheduler API

  2. 確認您有具備應用程式整合叫用者角色的 Google 服務帳戶。如果您沒有服務帳戶，請務必建立新的服務帳戶，並將「Application Integration Invoker」角色指派給該帳戶。

    如要瞭解如何建立及管理服務帳戶，請參閱「建立及管理服務帳戶」一文。

    如要瞭解預先定義的應用程式整合角色，請參閱「預先定義的 IAM 角色」。

新增 Cloud Scheduler 觸發條件

如要在整合中新增 Cloud Scheduler 觸發條件，請執行下列步驟：

  1. 前往 Google Cloud 控制台的「Application Integration」頁面。

    前往「應用程式整合」

  2. 在導覽選單中，按一下「整合」

    系統隨即會顯示「Integrations List」頁面，列出 Google Cloud 專案中可用的所有整合項目。

  3. 選取現有的整合，或按一下「建立整合」來建立新的整合。

    如果您要建立新的整合功能：

    1. 在「Create Integration」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取要用於整合的服務帳戶。您隨時可以透過整合工具列的 「整合摘要」窗格，變更或更新整合作業的服務帳戶詳細資料。
    4. 按一下 [建立]。

    新建立的整合服務會在整合服務編輯器中開啟。

  4. 在整合服務編輯器的導覽列中，按一下「觸發條件」，即可查看可用的觸發條件清單。
  5. 在整合服務編輯器中，按一下並放置「Cloud Scheduler trigger」(Cloud Scheduler 觸發條件) 元素。

設定 Cloud Scheduler 觸發條件

如要設定 Cloud Scheduler 觸發條件，請執行下列步驟：

  1. 按一下整合服務編輯器中的「Cloud Scheduler trigger」元素，開啟觸發條件設定窗格。

    使用下列任一選項指定 Cloud Scheduler 觸發事件的排程：

    • 基本：使用使用者介面設定 Cron 工作時間表。
    • 進階：使用 unix-cron 運算式設定 Cron 工作時間表。
  2. (適用於「基本」選項) 選取「基本」分頁，然後在指定欄位中執行下列操作：
    1. 時間：選取整合作業必須執行的時間間隔。
      • 在特定時間執行： 選取這個選項，即可在特定時間執行整合作業。
      • 每小時重複： 選取這個選項，即可每小時重複執行整合作業。
      • 每分鐘重複一次： 選取這個選項，即可依指定分鐘數重複執行整合作業
    2. 天數：選取整合作業必須執行的日期。您可以選擇每天、每週或每月特定幾天執行整合作業。
    3. 月份：選取整合作業必須執行的月份。您可以選擇每月或在特定月份執行整合作業。
  3. (進階選項) 選取「進階」分頁標籤，然後使用 Cron 運算式指定 Cron 工作時間表。

    Cron 運算式有五個值，必須依照以下順序指定：

    1. 分鐘 (0 到 59)
    2. 時 (0-23)
    3. 一個月內的第幾天 (1-31)
    4. 月份，下列任一值：
      • 1 到 12 之間的數字
      • 三個字母的月份縮寫 (例如 Jan、Feb、Mar)
    5. 星期幾，下列任一值：
      • 星期幾 (以星期日為 0)
      • 星期幾的三個字母縮寫 (例如：Mon、Tue、Wed)

    舉例來說，如要在每個月的第一天執行整合作業，請使用 * * 1 * * cron 運算式。

    詳情請參閱「設定 Cron 工作時間表」。

  4. 區域： 選取要部署 Cloud Scheduler 工作的區域。
  5. 服務帳戶電子郵件地址：輸入您建立的 Google 服務帳戶電子郵件地址。

觸發輸出

針對在整合版本中設定及發布的每個 Cloud Scheduler 觸發事件，應用程式整合會在 Google Cloud 專案中建立新的 Cloud Scheduler 工作。

建立 Cloud Scheduler 工作時，請使用下列命名慣例，以免發生工作重複錯誤： 

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER

示例：DemoIntegration__V1__1

觸發記錄檔

Cloud Scheduler 觸發事件會在每次整合執行作業的開始和結束時產生記錄。您可以在 Cloud Logging Logs Explorer 頁面中查看 Cloud Scheduler 觸發事件記錄：

  1. 在 Google Cloud 控制台中，前往「Cloud Scheduler」頁面。

    前往 Cloud Scheduler

  2. 找到 Cloud Scheduler 工作，然後按一下「Logs」欄中的「View」。

    系統會顯示「Cloud Logging Logs Explorer」頁面，其中顯示由 Cloud Scheduler 觸發事件產生的記錄。

編輯 Cloud Scheduler 觸發條件

應用程式整合

如要透過應用程式整合功能編輯 Cloud Scheduler 觸發條件，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Application Integration」頁面。

    前往「應用程式整合」

  2. 按一下左側導覽選單中的「整合」，開啟「整合」頁面。
  3. 選取要編輯的整合項目。
  4. 在整合服務編輯器中，按一下「Version」下拉式選單，然後選取含有您要編輯的 Cloud Scheduler 觸發條件的整合服務版本。
  5. 如果選取的整合版本已發布 (處於有效狀態)，請取消發布並啟用編輯功能。
  6. 按一下整合服務編輯器中的「Cloud Scheduler trigger」元素，開啟觸發條件設定窗格。
  7. 視需要修改 Cloud Scheduler 工作設定。

Cloud Scheduler

您可以透過 Cloud Scheduler 修改 Cloud Scheduler 工作的設定，來編輯 Cloud Scheduler 觸發條件：

  1. 前往 Google Cloud 控制台的「Cloud Scheduler」。

    前往 Cloud Scheduler

  2. 選取要編輯的 Cloud Scheduler 工作。
  3. 按一下 [編輯]。
  4. 視需要修改 Cloud Scheduler 工作設定。

暫停、繼續、複製 Cloud Scheduler 工作

應用程式整合功能不支援使用 Cloud Scheduler 觸發條件建立的 Cloud Scheduler 工作，因此無法執行暫停、繼續和複製作業。

如果您透過 Cloud Scheduler 手動暫停 Cloud Scheduler 工作的執行作業，Cloud Scheduler 觸發事件會在觸發事件設定窗格中擲回錯誤。

如要進一步瞭解 Cloud Scheduler 觸發事件錯誤訊息，請參閱「排解 Cloud Scheduler 觸發事件問題」。如要瞭解如何使用 Cloud Scheduler 暫停及恢復 Cron 工作，請參閱「暫停或恢復工作」一文。

刪除 Cloud Scheduler 工作

您可以透過應用程式整合或 Cloud Scheduler 刪除 Cloud Scheduler 工作。

應用程式整合

如要從應用程式整合功能中刪除 Cloud Scheduler 工作，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Application Integration」頁面。

    前往「應用程式整合」

  2. 按一下左側導覽選單中的「整合」，開啟「整合」頁面。
  3. 選取要編輯的整合項目。
  4. 在整合服務編輯器中，按一下「Version」下拉式選單，然後選取含有要刪除的 Cloud Scheduler 觸發條件的整合服務版本。
  5. 取消發布所選整合版本。

    系統會刪除對應整合版本的 Cloud Scheduler 工作。

Cloud Scheduler

如要從 Cloud Scheduler 刪除 Cloud Scheduler 工作，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Cloud Scheduler」。

    前往 Cloud Scheduler

  2. 選取要刪除的 Cloud Scheduler 工作。
  3. 按一下「刪除」。

    系統會刪除對應整合版本的 Cloud Scheduler 工作。

最佳做法

最佳做法是，當您不再需要任何 Cloud Scheduler 觸發事件時，請取消發布。如果您保留已發布的多餘 Cloud Scheduler 觸發事件，觸發事件會繼續自動叫用整合作業，可能會產生額外帳單費用。

排解 Cloud Scheduler 觸發條件問題

下表說明您可能會在 Cloud Scheduler 觸發事件中遇到的錯誤，以及這些錯誤的對應原因。

錯誤位置 發生錯誤 錯誤訊息 可能原因 解決方法
觸發條件設定窗格 > 錯誤訊息 Cloud Scheduler 工作停止執行整合作業 The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB does not exist. It might be deleted from your Google Cloud project. 使用 Cloud Scheduler 刪除 Cloud Scheduler 工作。 建立新的整合版本，以便覆寫現有的 Cloud Scheduler 工作。
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project. 使用 Cloud Scheduler 暫停 Cloud Scheduler 工作。 從 Cloud Scheduler 恢復 Cloud Scheduler 工作。
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error. 請檢查觸發記錄，找出問題。 建立新的整合版本，以便覆寫現有的 Cloud Scheduler 工作。
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation. 您提供的服務帳戶沒有必要的 IAM 權限。 如要從這個狀態復原工作，請重試 CloudScheduler.UpdateJob 作業，直到收到成功回應為止。
The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more. CLOUD_SCHEDULER_JOB_ISSUE 不適用

「服務水準協議」排除條款

Cloud Scheduler 觸發事件取決於 Cloud Scheduler 產品。由於此依附元件是應用程式整合功能的外部元件，因此只有在 active 整合作業的執行作業成功排程時，應用程式整合服務等級協議 (SLA) 條款和細則才適用。