Cancelar ejecuciones de flujos de procesamiento

Si ya no necesitas una ejecución de canalización programada o en curso, puedes cancelarla. Si hay varias ejecuciones de la canalización que quieres cancelar, puedes hacerlo en lote.

Cuando inicias la cancelación de una ejecución de un flujo de procesamiento, el estado de la ejecución cambia a Cancelando. Durante este estado, Vertex AI Pipelines cancela todas las tareas restantes del flujo de procesamiento y todos los Google Cloud servicios y recursos invocados por la ejecución del flujo de procesamiento. Una vez que se hayan cancelado todas estas tareas, servicios y recursos, el estado de la canalización cambiará a Cancelada.

Ten en cuenta que una ejecución de una canalización cancelada no se elimina. Puedes eliminar la ejecución de la canalización después de cancelarla.

Cancelar una ejecución de un flujo de procesamiento

Para cancelar una ejecución de una canalización, usa la Google Cloud consola, la API REST o el SDK de Vertex AI para Python.

Consola

Sigue estas instrucciones para cancelar una ejecución de flujo de trabajo en curso desde la Google Cloud consola:

1. En la sección Vertex AI, ve a la pestaña Ejecuciones de la página Pipelines.

   Ir a Carreras

2. En la columna Ejecución, haga clic en el nombre de la ejecución de la canalización que quiera cancelar.
3. En la página que muestra los detalles de la ejecución de la canalización, haga clic en Detener. Esta opción solo está disponible si la ejecución de la canalización tiene el estado Running (En ejecución).

Después de hacer clic en Detener, el estado de la canalización cambia a Cancelando. Una vez que se hayan cancelado todas las tareas, los servicios y los recursos de la canalización invocados por la ejecución, el estado cambiará a Cancelado. Google Cloud Google Cloud

REST

Para cancelar una ejecución de flujo de trabajo en curso o programada, envía una solicitud POST mediante el método pipelineJobs.cancel.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• LOCATION: la región en la que se encuentra la ejecución del flujo de procesamiento. Para obtener más información sobre las regiones en las que está disponible Vertex AI Pipelines, consulta la guía de ubicaciones de Vertex AI.
• PROJECT_ID: el Google Cloud proyecto que contiene la ejecución del flujo de procesamiento.
• PIPELINE_RUN_ID: ID único de la ejecución del flujo de procesamiento que quieres cancelar. El ID de ejecución del flujo de procesamiento se muestra en la pestaña Ejecuciones de la página Flujos de procesamiento de la Google Cloud consola.

Método HTTP y URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID:cancel

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID:cancel"

PowerShell

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID:cancel" | Select-Object -Expand Content

Deberías recibir un código de estado que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.

Python

Usa el siguiente ejemplo para cancelar una ejecución de una canalización en curso o programada mediante el método PipelineJob.cancel:

from google.cloud import aiplatform
aiplatform.init(project=PROJECT_ID, location=LOCATION)
pipeline_job = aiplatform.PipelineJob.get(resource_name="PIPELINE_RUN_ID")
pipeline_job.cancel()

Haz los cambios siguientes:

• PROJECT_ID: el Google Cloud proyecto que contiene la ejecución del flujo de procesamiento.
• LOCATION: la región en la que se encuentra la ejecución del flujo de procesamiento. Para obtener más información sobre las regiones en las que está disponible Vertex AI Pipelines, consulta la guía de ubicaciones de Vertex AI.
• PIPELINE_RUN_ID con el ID único de la ejecución de la canalización que quieras cancelar. El ID se muestra en la pestaña Ejecuciones de la página Pipelines de la consola deGoogle Cloud .

Cancelar varias ejecuciones de un flujo de procesamiento

Para cancelar varias ejecuciones de una canalización simultáneamente, usa la API REST o el SDK de Vertex AI para Python. Puedes cancelar por lotes las ejecuciones de flujos de trabajo que estén en el mismo proyecto y región.

REST

Para cancelar en lote varias ejecuciones de flujos de trabajo en curso o programadas, envía una solicitud POST con el método pipelineJobs.batchCancel.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• LOCATION: la región en la que se encuentran las ejecuciones de la canalización. Para obtener más información sobre las regiones en las que está disponible Vertex AI Pipelines, consulta la guía de ubicaciones de Vertex AI.
• PROJECT_ID: el Google Cloud proyecto que contiene las ejecuciones de flujo de procesamiento.
• PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: los IDs de los trabajos de la canalización que quieres cancelar. Puedes encontrar el ID de la tarea en la pestaña Ejecuciones de la página Pipelines de la Google Cloud consola.

Método HTTP y URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchCancel

Cuerpo JSON de la solicitud:

{
  "names": [
    "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_1",
    "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_2"
  ]
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchCancel"

PowerShell

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchCancel" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.BatchCancelPipelineJobsOperationMetadata",
    "genericMetadata": {
      "createTime": "2025-05-25T16:11:21.011113Z",
      "updateTime": "2025-05-25T16:11:21.011113Z"
    }
  }
}

Python

Usa el siguiente ejemplo para cancelar varias ejecuciones de canalizaciones en curso o programadas con el método PipelineJob.batch_cancel:

from google.cloud import aiplatform_v1
from google.api_core.client_options import ClientOptions
pipeline_run_ids_to_cancel = [
  "PIPELINE_RUN_ID_1",
  "PIPELINE_RUN_ID_2",
]
client_options = ClientOptions(api_endpoint=f"LOCATION-aiplatform.googleapis.com")
pipeline_job_client = aiplatform_v1.PipelineServiceClient(client_options=client_options)
pipeline_resource_names_to_cancel = []
for run_id in pipeline_run_ids_to_cancel:
  full_resource_name = f"projects/PROJECT_NUMBER/locations/LOCATION/pipelineJobs/{run_id.strip()}"
  pipeline_resource_names_to_cancel.append(full_resource_name)
parent = f"projects/PROJECT_ID/locations/LOCATION"
pipeline_job_client.batch_cancel_pipeline_jobs(parent=parent, names=pipeline_resource_names_to_cancel)

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto.
• LOCATION: la región en la que se crearon las ejecuciones del flujo de procesamiento.
• PROJECT_NUMBER: el número de tu proyecto. Puedes encontrar este número de proyecto en la Google Cloud consola.Para obtener más información, consulta el artículo Buscar el nombre, el número y el ID del proyecto.
• PIPELINE_RUN_ID_1 y PIPELINE_JOB_ID_2: los IDs únicos de las ejecuciones de la canalización que quieras cancelar. Los IDs de ejecución de la canalización se muestran en la pestaña Ejecuciones de la página Canalizaciones de la consola de Google Cloud .