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 disponibles, consulta la referencia de conectores.
Los conectores se pueden usar para conectarse a otras APIs de Google Cloud dentro de un flujo de trabajo y para integrar tus flujos de trabajo con esos productos de Google Cloud. Por ejemplo, puedes usar conectores para publicar mensajes de Pub/Sub, leer o escribir datos en una base de datos de Firestore, o recuperar claves de autenticación de Secret Manager. Obtén más información para usar un conector.
Los conectores simplifican los servicios de llamadas porque manejan el formato de las solicitudes por ti y proporcionan métodos y argumentos para que no necesites conocer los detalles de una API de Google Cloud.
Los conectores tienen un comportamiento integrado para controlar los reintentos y las operaciones de larga duración.
Autenticación
Los conectores usan la autenticación integrada de Identity and Access Management para interactuar con otros productos de Google Cloud. Ten en cuenta que un flujo de trabajo que usa un conector aún debe tener los permisos adecuados asignados a su cuenta de servicio para autenticarse correctamente en una API determinada. Por ejemplo, para publicar un mensaje en
Pub/Sub, la cuenta de servicio asociada con tu flujo de trabajo debe
tener el rol roles/pubsub.publisher.
Para obtener más información sobre la autenticación en otros productos de Google Cloud, consulta Cómo otorgar permiso a un flujo de trabajo para acceder a recursos de Google Cloud.
Reintentos
Todos los conectores aplican la siguiente política de reintento y las siguientes configuraciones de manejo de errores:
Workflows usa una política de reintento idempotente para las solicitudes GET.
Workflows usa una política de reintento no idempotente para todos los demás métodos HTTP.
De forma predeterminada, las solicitudes agotan el tiempo de espera después de 30 minutos. Ten en cuenta que, en el caso de las operaciones de larga duración, esto se aplica a las solicitudes individuales (por ejemplo, iniciar la operación o verificar su estado) dentro de la operación de larga duración. El tiempo de espera de toda la operación se puede configurar con el campo
connector_params. Consulta la referencia de conectores.
Operaciones de larga duración
En el caso de las llamadas que realizan una operación de larga duración, se aplican los siguientes comportamientos:
Workflows bloquean la ejecución del flujo de trabajo hasta que la operación se completa correctamente o falla.
De forma predeterminada, las llamadas agotan el tiempo de espera después de 30 minutos. El tiempo de espera de la llamada se puede cambiar 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 sondea, comienza con 1 segundo y disminuye a 60 segundos entre sondeos. Cada intento de sondeo se cuenta como un paso facturable. Los parámetros de sondeo se pueden cambiar con el campo
connector_params. Consulta la referencia de conectores.El mecanismo de reintento anterior se aplica a un intento de sondeo fallido.
Se verifican las respuestas de sondeo y, si la carga útil de la respuesta no es válida, se muestra un error
ResponseTypeError.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 de larga duración, 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: Es el objeto de operación de larga duración que falló.
Para obtener una lista detallada de los tipos de operaciones de larga duración compatibles, consulta la referencia de conectores.