刪除管線執行作業

如果專案包含失敗或取消的管道執行作業，您可以刪除這些作業。 批次刪除作業最多可刪除 32 個管道執行作業。

啟動管道執行作業刪除程序後，管道執行作業的狀態會變更為「正在刪除」。如果管道執行作業在這個狀態中停留一小時，Vertex AI Pipelines 就會將其排入永久刪除佇列。隨後，系統會每天排定作業，永久移除所有已排定永久刪除的管道執行作業。

刪除管道執行作業

如要刪除 pipeline 執行作業，請使用 Google Cloud 控制台、REST API 或 Python 適用的 Vertex AI SDK。

控制台

如要從 Google Cloud 控制台刪除進行中的管道執行作業，請按照下列操作說明執行：

  1. 在 Vertex AI 專區中，前往「Pipelines」(管線) 頁面的「Runs」(執行) 分頁。

    前往「Runs」(執行作業)

  2. 找出要刪除的已取消或失敗的管道執行作業，然後選取旁邊的核取方塊。
  3. 按一下 [Delete] (刪除)，只有在管道執行作業處於「失敗」或「已取消」狀態時，才能使用這個選項。

按一下「刪除」後，管道執行的狀態會變更為「正在刪除」，然後永久刪除。

REST

如要刪除進行中或已排定的管道執行作業，請使用 pipelineJobs.delete 方法傳送 DELETE 要求。

使用任何要求資料之前，請先替換以下項目：

  • LOCATION：管道執行所在的區域。如要進一步瞭解 Vertex AI Pipelines 的適用區域，請參閱 Vertex AI 服務地區指南。
  • PROJECT_ID：包含管道執行的 Google Cloud 專案。
  • PIPELINE_RUN_ID：要刪除的管道執行作業專屬 ID。管道執行作業 ID 會顯示在 Google Cloud 控制台「管道」頁面的「執行作業」分頁中。

HTTP 方法和網址：

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

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

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

執行下列指令：

$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

您應該會收到如下的 JSON 回應：

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

使用下列範例，透過 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()

更改下列內容：

  • PROJECT_ID：包含管道執行的 Google Cloud 專案。
  • LOCATION：管道執行所在的區域。如要進一步瞭解 Vertex AI Pipelines 的適用區域，請參閱 Vertex AI 服務地區指南。
  • PIPELINE_RUN_ID，並提供要刪除的管道執行作業專屬 ID。ID 會顯示在Google Cloud 控制台的「管道」頁面中，位於「執行作業」分頁。

刪除多個管線執行作業

如要同時刪除多個失敗或已取消的 pipeline 執行作業，請使用Google Cloud 控制台、REST API 或 Python 適用的 Vertex AI SDK。您可以批次刪除位於相同專案和區域的管道執行作業。

控制台

如要從 Google Cloud 控制台刪除多個進行中的管道執行作業，請按照下列操作說明操作：

  1. 在 Vertex AI 專區中，前往「Pipelines」(管線) 頁面的「Runs」(執行) 分頁。

    前往「Runs」(執行作業)

  2. 找出要刪除的已取消或失敗的管道執行作業，然後勾選旁邊的核取方塊。
  3. 按一下 [Delete] (刪除)，只有在所有選取的管道執行作業都處於「失敗」或「已取消」狀態時，才能使用這個選項。

按一下「刪除」後，所選管線執行作業的狀態會變更為「正在刪除」，然後系統會永久刪除這些作業。

REST

如要批次刪除多個進行中或已排定的管道執行作業，請使用 pipelineJobs.batchDelete 方法傳送 POST 要求。

使用任何要求資料之前，請先替換以下項目：

  • LOCATION：管道執行作業所在的區域。如要進一步瞭解 Vertex AI Pipelines 的適用區域，請參閱 Vertex AI 服務地區指南。
  • PROJECT_ID：包含管道執行的 Google Cloud 專案。
  • PIPELINE_RUN_ID_1、PIPELINE_RUN_ID_2：要刪除的管道作業 ID。您可以在 Google Cloud 控制台的「Pipelines」(管線) 頁面中，找到「Runs」(執行) 分頁的工作 ID。

HTTP 方法和網址：

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

JSON 要求主體：

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

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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

您應該會收到如下的 JSON 回應：

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

使用下列範例，透過 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
)

取代下列內容：

  • PROJECT_ID：您的專案 ID。
  • PROJECT_ID：包含管道執行的 Google Cloud 專案。
  • PROJECT_NUMBER：專案的專案編號。您可以在 Google Cloud 控制台中找到這個專案編號。詳情請參閱「尋找專案名稱、編號和 ID」。
  • PIPELINE_RUN_ID_1、PIPELINE_RUN_ID_2：要刪除的管道作業 ID。管道執行作業 ID 會顯示在 Google Cloud 控制台的「管道」頁面「執行作業」分頁中。