查看 Application Integration 支援的連接器。

暫停工作

暫停工作可暫時停止整合作業，然後再繼續執行。

在整合作業執行期間，當控制項到達「暫停」工作時，執行作業會停止，且「暫停」工作後的所有工作都會暫停。發生下列任一事件時，整合作業就會繼續執行：

  • 指定停權時間到期。
  • 收到 Suspensions API 的繼續執行要求後。

您也可以為「暫停」工作設定輸出變數 (「暫停結果」)，並將其設為任何值，然後使用該值建立分支條件，以執行下游工作。

比較「核准」工作、「暫停」工作和「計時器」工作

這三項工作 (「核准」、「暫停」和「計時器」) 的功能類似，都是暫停及恢復整合。不過，這兩者之間還是有些許差異。下表說明這三項工作的差異。

審核工作 暫停工作 計時器工作
不支援自動恢復整合，需要手動介入才能恢復整合。 支援手動和自動恢復整合。如果沒有手動介入撤銷暫停，整合會在暫停時間限制到期後自動恢復執行。 僅支援自動恢復整合。停權時間限制到期後，整合作業會自動繼續執行。
無法透過 API 呼叫繼續整合。您必須使用整合 UI 手動解決暫停問題。 您可以使用整合的 Suspensions API 繼續整合。 僅支援自動恢復整合。
整合服務暫停 (停權) 時，使用者會收到通知。 整合服務暫停 (停權) 時，使用者不會收到任何通知。 整合服務暫停 (停權) 時，使用者不會收到任何通知。
支援輸出變數 (布林值)，可讓您在繼續整合作業前執行條件檢查。不過，輸出變數的值只能是 true 或 false。 支援輸出變數 (字串)，讓您在繼續整合前執行條件檢查。您可以為輸出變數設定任何值。 不支援任何輸出變數。

設定暫停工作

如要設定「暫停」工作，請執行下列步驟：

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

    前往「Application Integration」

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

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

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

    如要建立新的整合項目：

    1. 在「建立整合」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
    4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。

  4. 在整合編輯器的導覽列中，按一下「Tasks」(工作)，即可查看可用工作和連結器的清單。
  5. 在整合服務編輯器中，按一下並放置「暫停」工作元素。
  6. 在設計工具中，按一下「暫停」工作元素，即可查看「暫停」工作設定窗格。
  7. 使用工作設定屬性，設定其餘欄位，詳情請參閱下表。

    系統會自動儲存您對屬性所做的所有變更。

設定屬性

下表說明「暫停」工作的設定屬性。

屬性 資料類型 說明
Suspension Time 整數 整合執行作業必須暫停的時間 (以分鐘為單位)。時間限制上限為 44640 分鐘 (31 天)，這也是預設值。

如果整合執行作業未在指定時間限制內繼續，整合服務會在時間限制到期後自動繼續執行，並將 Suspension result 變數的值設為 Expired。
Suspension result String 用於儲存暫停工作結果的變數。您可以選擇是否為這個變數設定值。您可以根據需求將這個變數設為任何值。如要進一步控管整合的執行流程，這個變數會很有幫助。舉例來說，您可以讀取暫停結果，並根據任何下游工作中的值，設定條件式決策。
Suspension Id 字串 暫停工作的專屬 ID。整合服務暫停後，系統會立即設定這個變數的值。您可以在整合 UI 的「執行記錄」頁面中取得 ID 值。如果您使用 API 觸發整合，也可以從 API 的回應物件取得 ID 值。

您可以使用暫停 ID 或整合項目的執行 ID，繼續執行整合。

使用 Suspensions API 撤銷停權處置

您可以使用 Suspensions API，透過 API 呼叫撤銷停權處分。如要使用 Suspensions API 撤銷停權處分，您必須擁有整合的執行 ID，或是 Suspend 工作的停權 ID。如要撤銷停權處分，請對下列 API 發出 POST 要求：

https://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift

在這個 API 中，INTEGRATION_ID 為選用項目。不過，您必須提供 EXECUTION_ID 或 SUSPENSION_ID。如果沒有任何 ID 值，可以將值替換為 -。在這個 API 中，REGION、PROJECT 和 LOCATION 是必填欄位。

撤銷暫停後，整合執行作業會繼續執行，並在「暫停」工作後執行下游工作。

下列範例說明如何使用 suspensions API 撤銷停權處分。

範例 1：只使用停權 ID 撤銷停權處分

下列 curl 指令說明如何只使用停權 ID 撤銷停權處分：

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"Approved"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift

在本範例中，Suspension result 變數會針對暫停 ID c6a13a79-a918-41e2-82b9-32b5a010755a 設為 Approved。

範例 2：只使用執行 ID 撤銷停權處分

下列 curl 指令說明如何僅使用執行 ID 撤銷暫停處分：

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"true"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift

在本範例中，Suspension result 變數會針對執行 ID 76a391e7-c801-45d7-8046-eab20d167ec5 設為 true。

範例 3：同時使用執行作業 ID 和暫停 ID 撤銷暫停處分

如果您同時擁有執行 ID 和暫停 ID，可以使用下列 curl 指令撤銷暫停處分：

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"{processname: "Release", owner: "John", status: "approved"};"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift

在本範例中，Suspension result 變數會針對暫停 ID f01815bf-ed18-4e01-9d41-cc2ce7861e95 設為 {processname: "Release", owner: "John", status: "approved"};。

錯誤處理策略

工作錯誤處理策略會指定工作因暫時性錯誤而失敗時，系統應採取的動作。如要瞭解如何使用錯誤處理策略，以及不同類型的錯誤處理策略，請參閱「錯誤處理策略」。

配額與限制

如要瞭解配額和限制，請參閱配額和限制。

後續步驟