Workflows 发布连接器,以便更轻松地在工作流中访问其他 Google Cloud API,并将您的工作流与这些 Google Cloud 产品集成。例如,您可以使用连接器发布 Pub/Sub 消息、读取或写入 Firestore 数据库,或者从 Secret Manager 检索身份验证密钥。如需详细了解可用连接器,请参阅连接器参考文档。
连接器简化了服务调用过程,因为它们会为您处理请求的格式设置,并提供方法和参数,因此您无需了解 Google Cloud API 的详细信息。如需详细了解身份验证以及在重试和长时间运行的操作期间的行为,请参阅了解连接器。
调用连接器调用
与调用 HTTP 端点类似,连接器调用需要 call
和 args
字段。您可以使用 connector_params
块指定超时值和轮询政策:
- STEP_NAME: call: CONNECTOR args: ARG: ARG_VALUE [...] body: KEY:KEY_VALUE [...] connector_params: timeout: TIMEOUT_IN_SECONDS polling_policy: initial_delay: INITIAL_DELAY_IN_SECONDS multiplier: MULTIPLIER_VALUE max_delay: MAX_DELAY_IN_SECONDS skip_polling: SKIP_POLLING_SWITCH scopes: OAUTH2_SCOPE result: RESPONSE_VALUE
替换以下内容:
STEP_NAME
:步骤的名称。CONNECTOR
(必需):googleapis.gcp_service.version.resource.operation
格式的连接器方法。例如googleapis.bigquery.v2.tables.get
。ARG
和ARG_VALUE
(必需):每个连接器调用都需要不同的参数。KEY
和KEY_VALUE
(可选):用于向 API 提供输入的字段。- 特定于连接器的参数(可选):
TIMEOUT_IN_SECONDS
:时间(以秒为单位)。 在抛出超时异常之前,允许连接器调用运行的端到端时长。默认值为1800
,这应该是非长时间运行的操作的连接器方法的最大值。否则,对于长时间运行的操作,连接器调用的最长超时时间为31536000
秒(一年)。INITIAL_DELAY_IN_SECONDS
:轮询政策参数,默认值为1.0
。仅适用于长时间运行的操作调用。MULTIPLIER_VALUE
:轮询政策参数,默认值为1.25
。仅适用于长时间运行的操作调用。MAX_DELAY_IN_SECONDS
:轮询政策参数,默认值为60.0
。仅适用于长时间运行的操作调用。SKIP_POLLING_SWITCH
:如果设置为True
,那么如果管理或更新资源的初始请求成功(通常为HTTP POST
、HTTP UPDATE
或HTTP DELETE
),则连接器调用调用不会阻塞。如果初始请求未成功,可能会发生重试。初始请求完成后,系统会跳过长时间运行的操作的状态轮询(初始请求后的HTTP GET
请求)。默认值为False
。OAUTH2_SCOPE
:要传递给 Google API 的 OAuth2 范围。可以是字符串、字符串列表、以空格分隔的字符串或逗号分隔字符串。
RESPONSE_VALUE
(可选):用于存储连接器调用调用步骤结果的变量名称。
示例
以下工作流演示了如何使用 Cloud Storage API 连接器和 Cloud Translation API 连接器将两个文件翻译为法语和西班牙语,并将结果保存在 Cloud Storage 存储桶中。