O Workflows publica conectores para facilitar o acesso a outras APIs do Google Cloud em um fluxo de trabalho e integrar seus fluxos de trabalho a esses produtos do Google Cloud. Por exemplo, é possível usar conectores para publicar mensagens do Pub/Sub, ler ou gravar dados em um banco de dados do Firestore ou recuperar chaves de autenticação do Secret Manager. Para um consultar os conectores disponíveis, consulte a Referência de conectores.
Os conectores simplificam os serviços de chamada porque processam a formatação das solicitações, fornecendo métodos e argumentos para que você não precise conhecer os detalhes de uma API Google Cloud. Para saber mais sobre a autenticação e o comportamento durante as tentativas e operações de longa duração, consulte Noções básicas sobre conectores.
Invocar uma chamada de conector
Semelhante à invocação de um endpoint HTTP,
uma chamada de conector requer os campos call
e args
. É possível especificar um valor de
tempo limite e uma política de pesquisa usando o bloco 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
Substitua:
STEP_NAME
: o nome da etapa.CONNECTOR
(obrigatório): o método do conector no formulário.googleapis.gcp_service.version.resource.operation
. Por exemplo,googleapis.bigquery.v2.tables.get
.ARG
eARG_VALUE
(obrigatórios): cada chamada de conector requer argumentos diferentes.KEY
eKEY_VALUE
(opcional): campos para fornecer entrada à API.- Parâmetros específicos do conector (opcional):
TIMEOUT_IN_SECONDS
: tempo em segundos. A duração completa em que a chamada do conector pode ser executada antes de gerando uma exceção de tempo limite. O valor padrão é1800
e precisa ser o máximo para métodos de conector que não são operações de longa duração. Caso contrário, para operações de longa duração, o tempo limite máximo para uma chamada de conector é de31536000
segundos (um ano).INITIAL_DELAY_IN_SECONDS
: parâmetro de política de pesquisa com um valor padrão de1.0
. Aplica-se apenas a chamadas de operação de longa duração.MULTIPLIER_VALUE
: parâmetro de política de pesquisa com um valor padrão de1.25
. Aplica-se apenas a chamadas de operações de longa duração.MAX_DELAY_IN_SECONDS
: parâmetro da política de pesquisa com um valor padrão de60.0
. Aplicável apenas a operação de longa duração chamadas.SKIP_POLLING_SWITCH
: se definido comoTrue
, a chamada de invocação do conector não bloqueia se a solicitação inicial para gerenciar ou atualizar o recurso for bem-sucedida (normalmenteHTTP POST
,HTTP UPDATE
ouHTTP DELETE
). Se a solicitação inicial não for bem-sucedida, poderão ocorrer tentativas. A pesquisa de status (solicitaçõesHTTP GET
que seguem a inicial) é ignorada para a operação de longa duração após a conclusão da solicitação inicial. O valor padrão éFalse
.OAUTH2_SCOPE
: os escopos do OAuth2 a serem transmitidos para o API do Google. Pode ser uma string, uma lista de strings, uma string separada por espaços ou uma string separada por vírgulas.
RESPONSE_VALUE
(opcional): nome da variável em que o resultado de uma etapa de invocação de chamada de conector é armazenado.
Exemplo
O fluxo de trabalho a seguir demonstra o uso do conector da API Cloud Storage e do conector da API Cloud Translation para traduzir dois arquivos para o francês e o espanhol, salvando os resultados em um bucket do Cloud Storage.