Esta página foi traduzida pela API Cloud Translation.

Elimine execuções de pipelines

Se o seu projeto contiver execuções de pipelines com falhas ou canceladas, pode eliminá-las. Pode eliminar um máximo de 32 execuções de pipelines numa operação de eliminação em lote.

Quando inicia a eliminação de uma execução da pipeline, o estado da execução da pipeline muda para A ser eliminada. Depois de a execução do pipeline permanecer neste estado durante uma hora, o Vertex AI Pipelines coloca-a em fila para eliminação permanente. Posteriormente, uma operação agendada diariamente remove permanentemente todas as execuções de pipelines colocadas em fila para eliminação permanente.

Elimine uma execução de pipeline

Para eliminar uma execução de pipeline, use a Google Cloud consola, a API REST ou o SDK Vertex AI para Python.

Consola

Use as instruções seguintes para eliminar uma execução de pipeline em curso a partir da Google Cloud consola:

Na secção Vertex AI, aceda ao separador Execuções na página Pipelines.

Aceda a Execuções
Selecione a caixa de verificação junto a uma execução de pipeline cancelada ou com falhas que quer eliminar.
Clique em Eliminar. Esta opção só está disponível se a execução do pipeline estiver no estado Falhou ou Cancelado.

Depois de clicar em Eliminar, o estado da execução da pipeline muda para A ser eliminada, antes de ser eliminada permanentemente.

REST

Para eliminar uma execução de pipeline em curso ou agendada, envie um pedido DELETE através do método pipelineJobs.delete.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

LOCATION: a região onde a execução do pipeline está localizada. Para mais informações acerca das regiões onde o Vertex AI Pipelines está disponível, consulte o guia de localizações da Vertex AI.
PROJECT_ID: o Google Cloud projeto que contém a execução do pipeline.
PIPELINE_RUN_ID: o ID exclusivo da execução da pipeline que quer eliminar. O ID da execução do pipeline é apresentado no separador Execuções na página Pipelines na Google Cloud consola.

Método HTTP e URL:

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

Para enviar o seu pedido, escolha uma destas opções:

curl

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

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

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 seguinte exemplo para eliminar uma execução de pipeline com falha ou cancelada através do 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()

Substitua o seguinte:

PROJECT_ID: o Google Cloud projeto que contém a execução do pipeline.
LOCATION: a região onde a execução do pipeline está localizada. Para mais informações acerca das regiões onde o Vertex AI Pipelines está disponível, consulte o guia de localizações da Vertex AI.
PIPELINE_RUN_ID com o ID exclusivo da execução do pipeline que quer eliminar. O ID é apresentado no separador Execuções na página Pipelines na Google Cloud consola.

Elimine várias execuções de pipelines

Para eliminar várias execuções de pipelines com falhas ou canceladas em simultâneo, use a Google Cloud consola, a API REST ou o SDK do Vertex AI para Python. Pode eliminar em lote execuções de pipelines que estejam no mesmo projeto e região.

Consola

Use as seguintes instruções para eliminar várias execuções de pipelines em curso a partir da Google Cloud consola:

Na secção Vertex AI, aceda ao separador Execuções na página Pipelines.

Aceda a Execuções
Selecione as caixas de verificação junto às execuções de pipelines canceladas ou com falhas que quer eliminar.
Clique em Eliminar. Esta opção só está disponível se todas as execuções do pipeline selecionadas estiverem no estado Falhou ou Cancelado.

Depois de clicar em Eliminar, o estado das execuções da pipeline selecionada muda para A ser eliminada, antes de as execuções serem eliminadas permanentemente.

REST

Para eliminar em lote várias execuções de pipelines em curso ou agendadas, envie um pedido POST através do método pipelineJobs.batchDelete.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

LOCATION: a região onde as execuções do pipeline estão localizadas. Para mais informações acerca das regiões onde o Vertex AI Pipelines está disponível, consulte o guia de localizações da Vertex AI.
PROJECT_ID: o Google Cloud projeto que contém as execuções do pipeline.
PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: os IDs das tarefas da pipeline que quer eliminar. Pode encontrar o ID da tarefa no separador Execuções da página Pipelines na Google Cloud consola.

Método HTTP e URL:

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

Corpo JSON do pedido:

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

Para enviar o seu pedido, escolha uma destas opções:

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 seguinte exemplo para eliminar várias execuções de pipelines em curso ou agendadas através do 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 o seguinte:

PROJECT_ID: o ID do seu projeto.
PROJECT_ID: o Google Cloud projeto que contém as execuções do pipeline.
PROJECT_NUMBER: o número do projeto. Pode localizar este número do projeto na Google Cloud consola. Para mais informações, consulte o artigo Encontre o nome, o número e o ID do projeto.
PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: os IDs das tarefas da pipeline que quer eliminar. Os IDs de execução do pipeline são apresentados no separador Execuções na página Pipelines na Google Cloud consola.

Elimine execuções de pipelines Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Elimine uma execução de pipeline

Consola

REST

curl

PowerShell

Python

Elimine várias execuções de pipelines

Consola

REST

curl

PowerShell

Python

Elimine execuções de pipelines