Comprende los conectores

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 API de Google Cloud en un flujo de trabajo y, también, para integrar los flujos de trabajo en 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 información para usar un conector.

Los conectores simplifican los servicios de llamadas porque controlan 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 necesita tener asignados los permisos adecuados a su cuenta de servicio para autenticarse de forma adecuada 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 Otorga permiso a un flujo de trabajo para acceder a los recursos de Google Cloud.

Reintentos

Todos los conectores aplican la siguiente política de reintento y las 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, el tiempo de espera de las solicitudes se agota 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 mediante el campo 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 complete de forma correcta o falle.

  • De forma predeterminada, el tiempo de espera de las llamadas se agota después de 30 minutos. El tiempo de espera de la llamada se puede cambiar mediante el campo connector_params (hasta un año como máximo). 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 se ralentiza hasta 60 segundos entre sondeos. Cada intento de sondeo 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 a la encuesta 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 operaciones de larga duración, la lista incluye OperationError.
  • operation: El objeto de operación de larga duración con errores.

Para obtener una lista detallada de los tipos de operaciones de larga duración compatibles, consulta la Referencia de conectores.

¿Qué sigue?