Workflows publica conectores para facilitar el acceso a otros productosGoogle 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 dentro de un flujo de trabajo e integrar tus flujos de trabajo con esos productos. Google Cloud Google CloudPor 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. Consulta cómo usar un conector.
Los conectores simplifican las llamadas a servicios, ya que se encargan de dar formato a las solicitudes, y proporcionan métodos y argumentos para que no tengas que conocer los detalles de una API de Google Cloud .
Los conectores tienen un comportamiento integrado para gestionar los reintentos y las operaciones de larga duración.
Autenticación
Los conectores usan la autenticación de gestión de identidades y accesos integrada para interactuar con otros productos deGoogle Cloud . Ten en cuenta que un flujo de trabajo que use un conector 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 a tu flujo de trabajo debe tener asignado el rol roles/pubsub.publisher.
Para obtener más información sobre cómo autenticarte en otros productos de Google Cloud , consulta Conceder permiso a un flujo de trabajo para acceder a recursos de Google Cloud .
Reintentos
Todos los conectores aplican las siguientes configuraciones de política de reintento y de gestión de errores:
Workflows usa una política de reintentos idempotente para las solicitudes GET.
Los flujos de trabajo usan una política de reintentos 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 comprobar 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 bloquea 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 periódicamente las operaciones de larga duración. De forma predeterminada, Workflows usa un tiempo de espera exponencial de 1,25 al sondear, que empieza con 1 segundo y se ralentiza hasta 60 segundos entre sondeos. Cada intento de sondeo cuenta como un paso facturable. Los parámetros de sondeo se pueden cambiar mediante el campo
connector_params. Consulta la referencia de conectores.El mecanismo de reintento anterior se aplica a un intento de sondeo fallido.
Se comprueban las respuestas de la encuesta y, si la carga útil de la respuesta no es válida, se devuelve 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 genera una excepción con los siguientes atributos:
message: mensaje de error legible por humanos.tags: una lista de etiquetas. En el caso de las llamadas de conectores de operaciones de larga duración, la lista incluyeOperationError.operation: el objeto de la operación de larga duración fallida.
Para ver una lista detallada de los tipos de operaciones de larga duración admitidos, consulta la referencia de conectores.