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 cancelarlas por lotes.

Cuando inicias la cancelación de una ejecución de canalización, el estado de la ejecución de la canalización cambia a Cancelando. Durante este estado, Gemini Enterprise Agent Platform Pipelines cancela todas las tareas restantes de la canalización y todos los Cloud de Confiance by S3NS servicios y recursos invocados por la ejecución de la canalización. Después de que se cancelan todas estas tareas, servicios y recursos, el estado de la canalización cambia a Cancelada.

Ten en cuenta que no se borra una ejecución de canalización cancelada. Tienes la opción de borrar la ejecución de la canalización después de cancelarla.

Cancela una ejecución de canalización

Para cancelar una ejecución de canalización, usa la Cloud de Confiance consola, la API de REST o el SDK de Agent Platform para Python.

Console

Usa las siguientes instrucciones para cancelar una ejecución de canalización en curso desde la Cloud de Confiance consola:

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

    Ir a Ejecuciones

  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 está en 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, Cloud de Confiance by S3NS los servicios y Cloud de Confiance by S3NS los recursos invocados por la ejecución, el estado cambia a Cancelada.

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 Agent Platform Pipelines, consulta la guía de ubicaciones de Gemini Enterprise Agent Platform.
  • PROJECT_ID: Es el Cloud de Confiance by S3NS proyecto que contiene la ejecución de la canalización.
  • PIPELINE_RUN_ID: Es el ID único de la ejecución de la canalización que deseas cancelar. El ID de la ejecución de la canalización se muestra en la pestaña Ejecuciones de la página Canalizaciones en la Cloud de Confiance 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

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

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 Cloud de Confiance by S3NS 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 Agent Platform Pipelines, consulta la guía de ubicaciones de Gemini Enterprise Agent Platform.
  • PIPELINE_RUN_ID por 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 Cloud de Confiance consola.

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 Agent Platform para Python. Puedes cancelar por lotes las ejecuciones de canalización que se encuentran en el mismo proyecto y región.

REST

Para cancelar por lotes varias ejecuciones de canalización 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 Agent Platform Pipelines, consulta la guía de ubicaciones de Gemini Enterprise Agent Platform.
  • PROJECT_ID: Es el Cloud de Confiance by S3NS 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 Cloud de Confiance 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

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

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 proyecto de tu proyecto. Puedes encontrar este número de proyecto en la Cloud de Confiance consola.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 la ejecución de la canalización se muestran en la pestaña Ejecuciones de la página Canalizaciones en la Cloud de Confiance consola.