Borrar ejecuciones de canalización

Si tu proyecto contiene ejecuciones de canalización 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 el borrado 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 canalización permanece en este estado durante una hora, las canalizaciones de Gemini Enterprise Agent Platform la ponen 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 Cloud de Confiance consola, la API de REST o el SDK de Agent Platform para Python.

Console

Usa las siguientes instrucciones para borrar 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. Selecciona la casilla de verificación junto a una ejecución de canalización cancelada o fallida que deseas borrar.
  3. Haz clic en Borrar. Esta opción solo está disponible si la ejecución de canalización está en el estado Fallida o Cancelada.

Después de hacer clic en Borrar, el estado de la ejecución de canalización cambia 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 request 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 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 canalización.
  • PIPELINE_RUN_ID: Es el ID único de la ejecución de canalización que deseas borrar. El ID de ejecución de 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: 

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 PipelineJob.delete método:

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

Borra varias ejecuciones de canalización

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

Console

Usa las siguientes instrucciones para borrar varias ejecuciones 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. Selecciona las casillas de verificación junto a las ejecuciones de canalización canceladas o fallidas que deseas borrar.
  3. Haz clic en Borrar. Esta opción solo está disponible si todas las ejecuciones de canalización seleccionadas están en el estado Fallida o Cancelada.

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

REST

Para borrar por lotes varias ejecuciones de canalización 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 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 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 Cloud de Confiance 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 PipelineJob.batch_delete método:

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: Es el ID del proyecto.
  • PROJECT_ID: Es el Cloud de Confiance by S3NS proyecto que contiene las ejecuciones de canalización.
  • PROJECT_NUMBER: Es el número de tu proyecto. Puedes encontrar este número de proyecto en la Cloud de Confiance consola. Para obtener más información, consulta Encuentra 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 canalización se muestran en la pestaña Ejecuciones de la página Canalizaciones en la Cloud de Confiance consola.