Información sobre 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 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 para 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 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 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 a 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 la siguiente política de reintento y las siguientes configuraciones de manejo de errores:

  • Workflows usa un política de reintento idempotente para 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 el tiempo de espera para toda la operación se puede configurar 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, 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 sondea, comienza con 1 segundo y disminuye a 60 segundos entre sondeos. 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 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 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 incluye OperationError.
  • 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 admitidos, consulta la Referencia de conectores.

¿Qué sigue?