Como funcionam os conectores

O Workflows publica conectores para facilitar o acesso a outros Google Cloud produtos em um fluxo de trabalho. Para uma referência detalhada sobre os conectores disponíveis, consulte a Referência de conectores.

Os conectores podem ser usados para se conectar a outras Google Cloud APIs em um fluxo de trabalho e integrar seus fluxos de trabalho a esses Google Cloud produtos. 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. Saiba como usar um conector.

Os conectores simplificam os serviços de chamada porque processam a formatação de solicitações para você, fornecendo métodos e argumentos para que você não precise ter a necessidade de saber os detalhes de uma Google Cloud API.

Os conectores têm um comportamento integrado para processar novas tentativas e operações de longa duração.

Autenticação

Os conectores usam a autenticação integrada do Identity and Access Management para interagir com outros Google Cloud produtos. Observe que um fluxo de trabalho que usa um conector ainda precisa ter as permissões apropriadas atribuídas à sua conta de serviço para ser autenticado corretamente em uma determinada API. Por exemplo, para publicar uma mensagem no Pub/Sub, a conta de serviço associada ao fluxo de trabalho precisa ter o papel roles/pubsub.publisher role. Para saber mais sobre a autenticação em outros Google Cloud produtos, consulte Conceder uma permissão de fluxo de trabalho para acessar Google Cloud recursos.

Novas tentativas

Todos os conectores aplicam as seguintes políticas de repetição e configurações de tratamento de erros:

  • Os fluxos de trabalho usam uma política de repetição idempotente para solicitações GET.

  • Esse produto usa uma política de repetição não idempotente para todos os outros métodos HTTP.

  • Por padrão, as solicitações expiram após 30 minutos. Observe que, para operações de longa duração, isso se aplica a solicitações individuais (por exemplo, iniciar a operação ou verificar o status dela) dentro da operação de longa duração. O campo connector_params pode ser usado para configurar o tempo limite de todas as operações. Consulte a referência dos conectores.

Operações de longa duração

Os seguintes comportamentos se aplicam para chamadas que executam uma operação de longa duração (LRO, na sigla em inglês):

  • Workflows bloqueiam a execução do fluxo até que ela seja concluída ou falhe.

  • Por padrão, as chamadas expiram após 30 minutos. O tempo limite da chamada pode ser alterado usando o campo connector_params (no máximo um ano). Consulte a referência dos conectores.

  • Os conectores pesquisam recursos de LRO periodicamente. Por padrão, Workflows usam uma espera exponencial de 1,25 ao pesquisar, começando com 1 segundo e diminuindo para 60 segundos entre as pesquisas. Cada tentativa de pesquisa conta como uma etapa faturável. É possível alterar os parâmetros de pesquisa usando o campo connector_params. Para uma lista dos tipos de recursos de LRO compatíveis, consulte a referência dos conectores.

  • O mecanismo anterior de novas tentativas é aplicado em caso de falha na tentativa de pesquisa.

  • As respostas de pesquisa são verificadas e, se o payload da resposta for inválido, um erro ResponseTypeError será retornado.

  • Quando ocorre um erro durante uma operação de longa duração, o Workflows gera um erro OperationError. O erro inclui outro atributo, error, que contém detalhes específicos da operação.

Se uma operação de longa duração falhar, a chamada do conector gerará uma exceção com os seguintes atributos:

  • message: mensagem legível de erro.
  • tags: uma lista de tags. Para uma chamada do conector de operação de longa duração, a lista inclui OperationError.
  • operation: o objeto da operação de longa duração com falha.

A seguir