Suspender una tarea

La tarea Suspender te permite pausar temporalmente y, a continuación, reanudar la ejecución de una integración.

Durante la ejecución de una integración, cuando el control llega a una tarea de suspensión, la ejecución se detiene y todas las tareas posteriores a la tarea de suspensión se suspenden. La integración reanuda la ejecución cuando se produce cualquiera de los siguientes eventos:

Vencimiento del tiempo de suspensión especificado.
Después de recibir una solicitud de reanudación de la ejecución de la API Suspensions.

También puedes configurar una variable de salida (Resultado de la suspensión) para la tarea Suspender y asignarle cualquier valor. Después, puedes usar ese valor para crear condiciones de ramificación que permitan ejecutar las tareas posteriores.

Comparar las tareas de aprobación, suspensión y temporizador

Las tres tareas (Aprobación, Suspender y Temporizador) realizan una función similar: pausar y reanudar una integración. Sin embargo, hay diferencias sutiles entre ellas. En la siguiente tabla se describen las diferencias entre las tres tareas.

Tarea de aprobación	Suspender una tarea	Tarea de temporizador
No admite la reanudación automática de una integración y requiere la intervención manual para reanudarla.	Admite la reanudación manual y automática de una integración. Si no se revoca la suspensión manualmente, la integración se reanudará automáticamente cuando finalice el plazo de suspensión.	Solo admite la reanudación automática de una integración. La ejecución de la integración se reanuda automáticamente una vez que ha transcurrido el tiempo límite de suspensión.
No se puede reanudar una integración mediante una llamada a la API. Debes resolver la suspensión manualmente mediante la interfaz de usuario de Integraciones.	Puede reanudar una integración mediante la API `Suspensions` para integraciones.	Solo admite la reanudación automática de una integración.
Los usuarios reciben una notificación cuando se pausa una integración (se suspende).	Los usuarios no reciben ninguna notificación cuando se pausa (suspende) una integración.	Los usuarios no reciben ninguna notificación cuando se pausa (suspende) una integración.
Admite una variable de salida (booleana) que te permite realizar comprobaciones condicionales antes de reanudar una integración. Sin embargo, la variable de salida solo puede tener el valor `true` o `false`.	Admite una variable de salida (cadena) que te permite realizar comprobaciones condicionales antes de reanudar una integración. Puedes asignar cualquier valor a la variable de salida.	No admite ninguna variable de salida.

Configurar la tarea Suspender

Para configurar la tarea Suspender, sigue estos pasos:

En la Google Cloud consola, ve a la página Integración de aplicaciones.
Ir a Application Integration
En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.
Seleccione una integración o haga clic en Crear integración para crear una.
Si vas a crear una integración:
1. Escribe un nombre y una descripción en el panel Crear integración.
2. Selecciona una región para la integración.
  Nota: En el menú desplegable Regiones solo se muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región, haga clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
  Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.
En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
Haz clic en el elemento de tarea Suspender y colócalo en el editor de integración.
Haga clic en el elemento de tarea Suspender en el diseñador para ver el panel de configuración de la tarea Suspender.
Configure los campos restantes con las propiedades de configuración de la tarea, tal como se detalla en las tablas de abajo.
Todos los cambios que hagas en las propiedades se guardarán automáticamente.

Propiedades de configuración

En la siguiente tabla se describen las propiedades de configuración de la tarea Suspender.

Propiedad	Data type (Dato)	Descripción
`Suspension Time`	Entero	Tiempo (en minutos) hasta que se debe suspender la ejecución de la integración. El límite de tiempo máximo es de 44.640 minutos (31 días), que también es el valor predeterminado. Si la ejecución de la integración no se reanuda en el plazo especificado, la integración se reanuda automáticamente una vez transcurrido el plazo y asigna el valor `Expired` a la variable `Suspension result`.
`Suspension result`	Cadena	Variable para almacenar el resultado de la tarea Suspender. Asignar un valor a esta variable es opcional. Puedes asignar a esta variable cualquier valor en función de tus requisitos. Esta variable es útil si quieres tener más control sobre el flujo de ejecución de tu integración. Por ejemplo, puede leer el resultado de la suspensión y configurar decisiones condicionales basadas en el valor de cualquiera de sus tareas posteriores.
`Suspension Id`	Cadena	Identificador único de la tarea de suspensión. El valor de esta variable se asigna inmediatamente después de que se suspenda la integración. Puede obtener el valor del identificador en la página Registros de ejecución de la interfaz de integración. También puedes obtener el valor del identificador del objeto de respuesta de una API si la usas para activar la integración. Puedes reanudar la ejecución de la integración mediante el ID de suspensión o el ID de ejecución de la integración.

Revocar una suspensión con la API Suspensions

La API Suspensions te permite revocar una suspensión mediante una llamada a la API. Para revocar una suspensión con la API Suspensions, debes tener el ID de ejecución de la integración o el ID de suspensión de la tarea Suspend. Para revocar una suspensión, debe enviar una solicitud POST a la siguiente API:

https://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift

En esta API, el INTEGRATION_ID es opcional. Sin embargo, debes proporcionar EXECUTION_ID o SUSPENSION_ID. Si no tiene ninguno de los valores de ID, puede sustituir el valor por -. En esta API, REGION, PROJECT y LOCATION son campos obligatorios.

Después de revocar la suspensión, la ejecución de la integración se reanuda y ejecuta las tareas posteriores a la tarea Suspend.

En los siguientes ejemplos se muestra cómo revocar una suspensión mediante la API suspensions.

Ejemplo 1: Revocar una suspensión solo con el ID de suspensión

El siguiente comando curl muestra cómo revocar una suspensión cuando solo tienes el ID de suspensión:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"Approved"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift

En este ejemplo, la variable Suspension result se asigna a Approved para el ID de suspensión c6a13a79-a918-41e2-82b9-32b5a010755a.

Ejemplo 2: Revocar una suspensión solo con el ID de ejecución

El siguiente comando curl muestra cómo revocar una suspensión cuando solo tienes el ID de ejecución:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"true"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift

En este ejemplo, la variable Suspension result se asigna a true para el ID de ejecución 76a391e7-c801-45d7-8046-eab20d167ec5.

Ejemplo 3: Revocar una suspensión con el ID de ejecución y el ID de suspensión

El siguiente comando curl muestra cómo revocar una suspensión cuando tienes tanto el ID de ejecución como el ID de suspensión:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"{processname: "Release", owner: "John", status: "approved"};"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift

En este ejemplo, la variable Suspension result se asigna a {processname: "Release", owner: "John", status: "approved"}; para el ID de suspensión f01815bf-ed18-4e01-9d41-cc2ce7861e95.

Estrategia de gestión de errores

Una estrategia de gestión de errores de una tarea especifica la acción que se debe llevar a cabo si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de gestión de errores y conocer los diferentes tipos de estrategias de gestión de errores, consulta Estrategias de gestión de errores.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

Siguientes pasos

Consulta información sobre todas las tareas y los activadores.
Consulta cómo probar y publicar una integración .

Consulta información sobre el tratamiento de errores.
Consulta información sobre los registros de ejecución de integraciones.