瞭解連接器

工作流程會發布連接器,方便您在工作流程中存取其他Google Cloud 產品。如需可用連接器的詳細參考資料,請參閱「連接器參考資料」。

連接器可用於在工作流程中連線至其他 API,並將工作流程與這些產品整合。 Google Cloud Google Cloud舉例來說,您可以使用連接器發布 Pub/Sub 訊息、讀取或寫入 Firestore 資料庫的資料,或是從 Secret Manager 擷取驗證金鑰。瞭解如何使用連接器

連接器會處理要求的格式化作業,並提供方法和引數,因此您不必瞭解 Google Cloud API 的詳細資料,即可簡化服務呼叫作業。

連接器內建處理重試長時間執行作業的行為。

驗證

連結器會使用內建的身分與存取權管理驗證,與其他Google Cloud 產品互動。請注意,使用連接器的工作流程仍須為服務帳戶指派適當權限,才能正確驗證特定 API。舉例來說,如要將訊息發布至 Pub/Sub,與工作流程相關聯的服務帳戶必須獲派 roles/pubsub.publisher 角色。如要進一步瞭解如何驗證其他 Google Cloud 產品,請參閱「授予工作流程權限,以便存取 Google Cloud 資源」。

重試

所有連接器都會套用下列重試政策和錯誤處理設定:

  • 工作流程會對 GET 要求使用等冪重試政策

  • 對於所有其他 HTTP 方法,Workflows 會使用非等冪重試政策

  • 根據預設,要求會在 30 分鐘後逾時。請注意,如果是長時間執行的作業,這項限制適用於長時間執行作業中的個別要求 (例如啟動作業或檢查作業狀態)。您可以使用 connector_params 欄位,設定整個作業的逾時時間。請參閱連接器參考資料

長期執行的作業

如為執行長時間執行的作業 (LRO) 的呼叫,適用下列行為:

  • 工作流程會封鎖工作流程執行作業,直到作業成功完成或失敗為止。

  • 根據預設,通話會在 30 分鐘後逾時。您可以使用 connector_params 欄位變更呼叫的逾時時間 (最長為一年)。請參閱連接器參考資料

  • 連接器會定期輪詢 LRO 資源。根據預設,工作流程在輪詢時會使用 1.25 的指數輪詢,從 1 秒開始,輪詢間隔會逐漸減緩至 60 秒。每次輪詢嘗試都會計為一個計費步驟。您可以使用 connector_params 欄位變更輪詢參數。如需支援的 LRO 資源類型清單,請參閱連結器參考資料

  • 上述重試機制適用於輪詢嘗試失敗的情況。

  • 系統會檢查輪詢回應,如果回應酬載無效,則會傳回 ResponseTypeError 錯誤。

  • 如果長時間執行的作業發生錯誤,Workflows 會引發 OperationError 錯誤。錯誤包含額外屬性 error,其中含有作業專屬詳細資料。

如果長時間執行的作業失敗,連接器呼叫會擲回例外狀況,並包含下列屬性:

  • message:使用者可自然閱讀的錯誤訊息。
  • tags:標記清單。如果是長時間執行的作業連接器呼叫,清單會包含 OperationError
  • operation:失敗的長時間執行的作業物件。

後續步驟