Borrar ejecuciones de canalización

Si tu proyecto contiene ejecuciones de canalizaciones fallidas o canceladas, puedes borrarlas. Puedes borrar un máximo de 32 ejecuciones de canalización en una operación de eliminación por lotes.

Cuando inicias la eliminación de una ejecución de canalización, el estado de la ejecución de canalización cambia a Se está borrando. Después de que la ejecución de la canalización permanece en este estado durante una hora, Vertex AI Pipelines la pone en cola para su eliminación permanente. Posteriormente, una operación programada diaria quita de forma permanente todas las ejecuciones de canalización en cola para su eliminación permanente.

Borra una ejecución de canalización

Para borrar 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 borrar 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. Selecciona la casilla de verificación junto a la ejecución de la canalización cancelada o fallida que deseas borrar.
  3. Haz clic en Borrar. Esta opción solo está disponible si la ejecución de la canalización tiene el estado Failed o Canceled.

Después de hacer clic en Borrar, el estado de la ejecución de la canalización cambiará a Se está borrando antes de que se borre de forma permanente.

REST

Para borrar una ejecución de canalización en curso o programada, envía una solicitud DELETE con el método pipelineJobs.delete.

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 borrar. 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:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID"

PowerShell

Ejecuta el siguiente comando:

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2025-07-25T16:23:47.201943Z",
      "updateTime": "2025-07-25T16:23:47.201943Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Python

Usa el siguiente ejemplo para borrar una ejecución de canalización fallida o cancelada con el método PipelineJob.delete:

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

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 borrar. El ID se muestra en la pestaña Ejecuciones de la página Canalizaciones en la consola deGoogle Cloud .

Borra varias ejecuciones de canalización

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

Console

Sigue estas instrucciones para borrar varias ejecuciones 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. Selecciona las casillas de verificación junto a las ejecuciones de canalización canceladas o con errores que deseas borrar.
  3. Haz clic en Borrar. Esta opción solo está disponible si todas las ejecuciones de la canalización seleccionadas tienen el estado Failed o Canceled.

Después de hacer clic en Borrar, el estado de las ejecuciones de canalización seleccionadas cambiará a Se está borrando antes de que se borren de forma permanente.

REST

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

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 borrar. 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:batchDelete

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:batchDelete"

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:batchDelete" | 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.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2025-05-31T16:07:12.233655Z",
      "updateTime": "2025-05-31T16:07:12.233655Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.BatchDeletePipelineJobsResponse",
    "pipelineJobs": [
      {
        "name": "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_1"
      },
      {
        "name": "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_2"
      }
    ]
  }
}

Python

Usa el siguiente ejemplo para borrar varias ejecuciones de canalización en curso o programadas con el método PipelineJob.batch_delete:

from google.cloud import aiplatform_v1
from google.api_core.client_options import ClientOptions
pipeline_run_ids_to_delete = ["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_delete = [] for run_id in pipeline_run_ids_to_delete: full_resource_name = f"projects/PROJECT_NUMBER/locations/LOCATION/pipelineJobs/{run_id}" pipeline_resource_names_to_delete.append(full_resource_name) parent = f"projects/PROJECT_ID/locations/LOCATION"
pipeline_job_client.batch_delete_pipeline_jobs( parent=parent, names=pipeline_resource_names_to_delete )

Reemplaza lo siguiente:

  • PROJECT_ID: ID del proyecto
  • PROJECT_ID: Es el Google Cloud proyecto que contiene las ejecuciones de la canalización.
  • PROJECT_NUMBER: Es 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 Cómo encontrar el nombre, el número y el ID del proyecto.
  • PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: Son los IDs de los trabajos de canalización que deseas borrar. 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 .