Workflows publica conectores para facilitar el acceso a otros productos de Google Cloud dentro de un flujo de trabajo. Para obtener una referencia detallada de los conectores, consulta la Referencia de conectores.
Los conectores pueden usarse para conectarse a otras APIs de Google Cloud dentro un flujo de trabajo y que integres tus flujos de trabajo en los servicios productos. Por ejemplo, puedes usar conectores para publicar Pub/Sub leer o escribir datos en una base de datos de Firestore, o recuperar de autenticación de Secret Manager. Obtén más información sobre cómo usar un conector.
Los conectores simplifican los servicios de llamadas porque controlan el formateo de solicitudes por ti, y proporcionas métodos y argumentos para que no tengas que saber los detalles de una API de Google Cloud.
Los conectores tienen un comportamiento integrado para administrar reintentos y operaciones de larga duración.
Autenticación
Los conectores usan la autenticación integrada de Identity and Access Management para interactuar con otros
en todos los productos de Google Cloud. Ten en cuenta que un flujo de trabajo
que usa un conector
debe tener asignados los permisos adecuados a su cuenta de servicio para
autenticarse en una API determinada. Por ejemplo, para publicar un mensaje en
Pub/Sub, la cuenta de servicio asociada con tu flujo de trabajo
a los que se les otorgó el rol roles/pubsub.publisher.
Para obtener más información sobre la autenticación en otros productos de Google Cloud, consulta
Otorga permiso a un flujo de trabajo para acceder a los recursos de Google Cloud.
Reintentos
Todos los conectores aplican lo siguiente política de reintento y error manejar configuraciones:
Workflows usa un política de reintento idempotente para solicitudes GET.
Workflows usa un política de reintento no idempotente para todos los demás métodos HTTP.
De forma predeterminada, el tiempo de espera de las solicitudes se agota después de 30 minutos. Ten en cuenta que, en el caso de de servicio, esto se aplica a solicitudes individuales (por ejemplo, iniciar o la verificación de su estado) dentro de la operación de larga duración. El el tiempo de espera para toda la operación se puede configurar
connector_params. Consulta la Referencia de conectores.
Operaciones de larga duración
Para las llamadas que realizan una operación de larga duración, se aplican los siguientes comportamientos:
Workflows bloquea la ejecución del flujo de trabajo hasta que la operación se completa correctamente o falla.
De forma predeterminada, el tiempo de espera de las llamadas se agota después de 30 minutos. El tiempo de espera de la llamada puede ser se cambió con el campo
connector_params(hasta un máximo de un año). Consulta la Referencia de conectores.Los conectores sondean las operaciones de larga duración de forma periódica. De forma predeterminada, Workflows usa una retirada exponencial de 1.25 cuando se sondean, comenzando con 1 segundo y disminuyendo a 60 segundos entre encuestas. Cada intento de sondeo cuenta como un paso facturable. Los parámetros de sondeo pueden ser con el campo
connector_params. Consulta la Referencia de conectores.El mecanismo de reintento anterior se aplica a un intento de sondeo con errores.
Se verifican las respuestas de la encuesta y, si la carga útil de la respuesta no es válida, se crea Se muestra
ResponseTypeErrorerror.Cuando se produce un error durante una operación de larga duración, Workflows genera un error
OperationError. El error incluye un atributo adicional,error, que contiene detalles específicos de la operación
Si falla una operación prolongada, la llamada al conector arroja una excepción con los siguientes atributos:
message: Es un mensaje de error legible por humanos.tags: Es una lista de etiquetas. Para una llamada de conector de operación de larga duración, la lista incluyeOperationError.operation: El objeto de la operación de larga duración con errores.
Para obtener una lista detallada de los tipos de operaciones de larga duración admitidos, consulta la Referencia de conectores.