Cancela ejecuciones de canalizaciones

Si ya no necesitas una ejecución de canalización programada o en ejecución, puedes cancelarla. Si hay varias ejecuciones de canalización para cancelar, puedes hacerlo por lotes.

Cuando inicias la cancelación de una ejecución de canalización, el estado de la ejecución de canalización cambia a Cancelando. Durante este estado, Vertex AI Pipelines cancela todas las tareas restantes de la canalización y todos los servicios y recursos de Google Cloud invocados por la ejecución de la canalización. Después de cancelar todas estas tareas, servicios y recursos, el estado de la canalización cambia a Canceled.

Ten en cuenta que no se borra una ejecución de canalización cancelada. Después de cancelar la ejecución de la canalización, tienes la opción de borrarla.

Cancela la ejecución de una canalización

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

Console

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

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

   Ir a Runs

2. En la columna Ejecutar, haz clic en el nombre de la ejecución de canalización que deseas cancelar.
3. En la página que muestra los detalles de la ejecución de la canalización, haz clic en Detener. Esta opción solo está disponible si la ejecución de la canalización tiene el estado En ejecución.

Después de hacer clic en Detener, el estado de la canalización cambia a Cancelando. Después de que se cancelan todas las tareas de la canalización, los servicios de Google Cloud y los recursos deGoogle Cloud invocados por la ejecución, el estado cambia aCancelado.

REST

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• LOCATION: Es la región en la que se encuentra la ejecución 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: Es el Google Cloud proyecto que contiene la ejecución de la canalización.
• PIPELINE_RUN_ID: ID único de la ejecución de la canalización que deseas cancelar. El ID de ejecución de la canalización se muestra en la pestaña Ejecuciones de la página Canalizaciones en la consola de Google Cloud .

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: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$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 exitoso (2xx) y una respuesta vacía.

Python

Usa el siguiente ejemplo para cancelar una ejecución de canalización en curso o programada con 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()

Reemplaza lo siguiente:

• PROJECT_ID: Es el Google Cloud proyecto que contiene la ejecución de la canalización.
• LOCATION: Es la región en la que se encuentra la ejecución 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.
• PIPELINE_RUN_ID con el ID único de la ejecución de la canalización que deseas cancelar. El ID se muestra en la pestaña Ejecuciones de la página Canalizaciones en la consola deGoogle Cloud .

Cancela varias ejecuciones de canalización

Para cancelar varias ejecuciones de canalización de forma simultánea, usa la API de REST o el SDK de Vertex AI para Python. Puedes cancelar por lotes las ejecuciones de canalizaciones que se encuentran en el mismo proyecto y región.

REST

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• LOCATION: Es 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: Es el Google Cloud proyecto que contiene las ejecuciones de la canalización.
• PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: Son los IDs de los trabajos de canalización que deseas cancelar. Puedes encontrar el ID del trabajo en la pestaña Ejecuciones de la página Canalizaciones en 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: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, 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: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, 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 que se muestra a continuación:

{
  "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 canalización 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)

Reemplaza lo siguiente:

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