Excluir execuções de pipeline

Se o projeto tiver execuções de pipeline com falha ou canceladas, você poderá excluí-las. É possível excluir até 32 execuções de pipeline em uma operação de exclusão em lote.

Quando você inicia uma exclusão de execução de pipeline, o status dela muda para Em exclusão. Depois que a execução do pipeline permanece nesse status por uma hora, os pipelines da Gemini Enterprise Agent Platform a enfileiram para exclusão permanente. Em seguida, uma operação programada diária remove permanentemente todas as execuções de pipeline enfileiradas para exclusão permanente.

Excluir uma execução de pipeline

Para excluir uma execução de pipeline, use o Cloud de Confiance console, a API REST ou o SDK da Agent Platform para Python.

Console

Use as instruções a seguir para excluir uma execução de pipeline em andamento do Cloud de Confiance console:

  1. Na seção "Agent Platform", acesse a guia Execuções na página Pipelines.

    Acessar "Execuções"

  2. Marque a caixa de seleção ao lado de uma execução de pipeline cancelada ou com falha que você quer excluir.
  3. Clique em Excluir. Essa opção só estará disponível se a execução do pipeline estiver no status Com falha ou Cancelada.

Depois de clicar em Excluir, o status da execução do pipeline muda para Em exclusão, antes de ser excluído permanentemente.

REST

Para excluir uma execução de pipeline em andamento ou programada, envie uma solicitação DELETE request usando o método pipelineJobs.delete.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

  • LOCATION: a região em que a execução do pipeline está localizada. Para mais informações sobre as regiões em que os pipelines da Agent Platform estão disponíveis, consulte o Guia de locais da Gemini Enterprise Agent Platform.
  • PROJECT_ID: O Cloud de Confiance by S3NS projeto que contém a execução do pipeline.
  • PIPELINE_RUN_ID: o ID exclusivo da execução do pipeline que você quer excluir. O ID da execução do pipeline é exibido na guia Execuções na página Pipelines do Cloud de Confiance console.

Método HTTP e URL: 

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte 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

Execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Use o exemplo a seguir para excluir uma execução de pipeline com falha ou cancelada por meio do 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()

Substitua:

  • PROJECT_ID: O Cloud de Confiance by S3NS projeto que contém a execução do pipeline.
  • LOCATION: a região em que a execução do pipeline está localizada. Para mais informações sobre as regiões em que os pipelines da Agent Platform estão disponíveis, consulte o Guia de locais da Gemini Enterprise Agent Platform.
  • PIPELINE_RUN_ID pelo ID exclusivo da execução do pipeline que você quer excluir. O ID é exibido na guia Execuções na página Pipelines do Cloud de Confiance console.

Excluir várias execuções de pipeline

Para excluir várias execuções de pipeline com falha ou canceladas simultaneamente, use o Cloud de Confiance console, a API REST ou o SDK da Agent Platform para Python. É possível excluir em lote execuções de pipeline que estão no mesmo projeto e região.

Console

Use as instruções a seguir para excluir várias execuções de pipeline em andamento do Cloud de Confiance console:

  1. Na seção "Agent Platform", acesse a guia Execuções na página Pipelines.

    Acessar "Execuções"

  2. Marque as caixas de seleção ao lado das execuções de pipeline canceladas ou com falha que você quer excluir.
  3. Clique em Excluir. Essa opção só estará disponível se todas as execuções de pipeline selecionadas estiverem no status Com falha ou Cancelada.

Depois de clicar em Excluir, o status das execuções de pipeline selecionadas muda para Em exclusão, antes de serem excluídas permanentemente.

REST

Para excluir em lote várias execuções de pipeline em andamento ou programadas, envie uma solicitação POST request usando o método pipelineJobs.batchDelete.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

  • LOCATION: a região em que as execuções de pipeline estão localizadas. Para mais informações sobre as regiões em que os pipelines da Agent Platform estão disponíveis, consulte o Guia de locais da Gemini Enterprise Agent Platform.
  • PROJECT_ID: O Cloud de Confiance by S3NS projeto que contém as execuções de pipeline.
  • PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: os IDs dos jobs de pipeline que você quer excluir. É possível encontrar o ID do job na guia Execuções na página Pipelines doconsole. Cloud de Confiance

Método HTTP e URL: 

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

Corpo JSON da solicitação: 

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

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir: 

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

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir: 

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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

Use o exemplo a seguir para excluir várias execuções de pipeline em andamento ou programadas usando o 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
)

Substitua:

  • PROJECT_ID: o ID do projeto.
  • PROJECT_ID: O Cloud de Confiance by S3NS projeto que contém as execuções de pipeline.
  • PROJECT_NUMBER: o número do projeto. Você pode localizar esse número do projeto no Cloud de Confiance console. Para mais informações, consulte Encontrar o nome, o número e o ID do projeto.
  • PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: os IDs dos jobs de pipeline que você quer excluir. Os IDs de execução do pipeline são exibidos na guia Execuções na página Pipelines do Cloud de Confiance console.