O Workflows publica conetores para facilitar o acesso a outrosGoogle Cloud produtos num fluxo de trabalho. Para uma referência detalhada dos conetores disponíveis, consulte a referência de conetores.
Os conetores podem ser usados para estabelecer ligação a outras Google Cloud APIs num fluxo de trabalho e para integrar os seus fluxos de trabalho com esses produtos Google Cloud. Por exemplo, pode usar conetores para publicar mensagens do Pub/Sub, ler ou escrever dados numa base de dados do Firestore ou obter chaves de autenticação do Secret Manager. Saiba como usar um conector.
Os conetores simplificam os serviços de chamadas porque processam a formatação dos pedidos por si, fornecendo métodos e argumentos para que não precise de conhecer os detalhes de uma API Google Cloud .
Os conetores têm um comportamento incorporado para processar novas tentativas e operações de longa duração.
Google CloudAutenticação
Os conetores usam a autenticação de gestão de identidades e acessos integrada para interagir com outros
Google Cloud produtos. Tenha em atenção que um fluxo de trabalho que usa um conector continua a precisar de ter as autorizações adequadas atribuídas à respetiva conta de serviço para se autenticar corretamente numa determinada API. Por exemplo, para publicar uma mensagem no Pub/Sub, a conta de serviço associada ao seu fluxo de trabalho tem de ter a função roles/pubsub.publisher atribuída.
Para saber mais sobre a autenticação noutros Google Cloud produtos, consulte o artigo
Conceda uma autorização de fluxo de trabalho para aceder a Google Cloud recursos.
Novas tentativas
Todos os conetores aplicam a seguinte política de repetição e configurações de processamento de erros:
Os fluxos de trabalho usam uma política de repetição idempotente para pedidos GET.
Os fluxos de trabalho usam uma política de repetição não idempotente para todos os outros métodos HTTP.
Por predefinição, os pedidos excedem o tempo limite após 30 minutos. Tenha em atenção que, para operações de longa duração, isto aplica-se a pedidos individuais (por exemplo, iniciar a operação ou verificar o respetivo estado) na operação de longa duração. O tempo limite para toda a operação pode ser configurado através do campo
connector_params. Consulte a referência de conetores.
Operações de longa duração
Para chamadas que executam uma operação de execução prolongada, aplicam-se os seguintes comportamentos:
Os fluxos de trabalho bloqueiam a execução do fluxo de trabalho até que a operação seja concluída com êxito ou falhe.
Por predefinição, as chamadas excedem o tempo limite após 30 minutos. O limite de tempo da chamada pode ser alterado através do campo
connector_params(até um máximo de um ano). Consulte a referência de conetores.Os conetores sondam as operações de longa duração periodicamente. Por predefinição, o Workflows usa um recuo exponencial de 1,25 quando faz sondagens, começando com 1 segundo e diminuindo a velocidade para 60 segundos entre sondagens. Cada tentativa de sondagem conta como um passo faturável. Os parâmetros de sondagem podem ser alterados através do campo
connector_params. Consulte a referência de conetores.O mecanismo de repetição anterior aplica-se a uma tentativa de sondagem falhada.
As respostas da sondagem são verificadas e, se a carga útil da resposta for inválida, é devolvido um erro
ResponseTypeError.Quando ocorre um erro durante uma operação de longa duração, o Workflows gera um erro
OperationError. O erro inclui um atributo adicional,error, que contém detalhes específicos da operação.
Se uma operação de longa duração falhar, a chamada do conetor gera uma exceção com os seguintes atributos:
message: mensagem de erro legível por humanos.tags: uma lista de etiquetas. Para uma chamada de conector de operação de longa duração, a lista incluiOperationError.operation: o objeto de operação de longa duração com falha.
Para uma lista detalhada dos tipos de operações de longa duração suportados, consulte a referência de conectores.