Pipelineausführungen abbrechen

Wenn Sie einen geplanten oder laufenden Pipeline-Lauf nicht mehr benötigen, können Sie ihn abbrechen. Wenn Sie mehrere Pipelineausführungen abbrechen möchten, können Sie dies in einem Batch tun.

Wenn Sie eine Pipeline-Ausführung abbrechen, ändert sich der Status der Pipeline-Ausführung in Wird abgebrochen. In diesem Status werden alle verbleibenden Aufgaben in der Pipeline und alle von der Pipelineausführung aufgerufenen Google Cloud Dienste und Ressourcen von Vertex AI Pipelines abgebrochen. Nachdem alle diese Aufgaben, Dienste und Ressourcen gekündigt wurden, ändert sich der Pipeline-Status in Canceled (Gekündigt).

Ein abgebrochener Pipeline-Lauf wird nicht gelöscht. Nachdem Sie den Pipeline-Lauf abgebrochen haben, können Sie ihn löschen.

Pipelineausführung abbrechen

Wenn Sie einen Pipeline-Lauf abbrechen möchten, verwenden Sie die Google Cloud Console, die REST API oder das Vertex AI SDK für Python.

Console

So brechen Sie eine laufende Pipelineausführung über die Google Cloud Console ab:

1. Rufen Sie im Abschnitt „Vertex AI“ auf der Seite Pipelines den Tab Ausführungen auf.

   Zu „Ausführungen“

2. Klicken Sie in der Spalte Ausführung auf den Namen der Pipelineausführung, die Sie abbrechen möchten.
3. Klicken Sie auf der Seite mit den Details zum Pipeline-Lauf auf Beenden. Diese Option ist nur verfügbar, wenn sich der Pipeline-Lauf im Status Wird ausgeführt befindet.

Nachdem Sie auf Beenden geklickt haben, ändert sich der Status der Pipeline in Wird abgebrochen. Nachdem alle Pipeline-Aufgaben, Google Cloud -Dienste undGoogle Cloud -Ressourcen, die vom Lauf aufgerufen werden, abgebrochen wurden, ändert sich der Status in Abgebrochen.

REST

Senden Sie eine POST-Anfrage mit der Methode pipelineJobs.cancel, um einen laufenden oder geplanten Pipeline-Lauf abzubrechen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• LOCATION: Die Region, in der sich der Pipeline-Lauf befindet. Weitere Informationen zu den Regionen, in denen Vertex AI Pipelines verfügbar ist, finden Sie in der Anleitung zu Vertex AI-Standorten.
• PROJECT_ID: Das Google Cloud Projekt, das den Pipelineausführung enthält.
• PIPELINE_RUN_ID: Die eindeutige ID des Pipeline-Laufs, den Sie abbrechen möchten. Die ID der Pipelineausführung wird in der Google Cloud Console auf der Seite Pipelines auf dem Tab Ausführungen angezeigt.

HTTP-Methode und URL:

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

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID:cancel"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

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

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Python

Im folgenden Beispiel wird eine laufende oder geplante Pipelineausführung mit der Methode PipelineJob.cancel abgebrochen:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: Das Google Cloud Projekt, das den Pipelineausführung enthält.
• LOCATION: Die Region, in der sich der Pipeline-Lauf befindet. Weitere Informationen zu den Regionen, in denen Vertex AI Pipelines verfügbar ist, finden Sie in der Anleitung zu Vertex AI-Standorten.
• Ersetzen Sie PIPELINE_RUN_ID durch die eindeutige ID des Pipeline-Laufs, den Sie abbrechen möchten. Die ID wird in derGoogle Cloud Console auf der Seite Pipelines auf dem Tab Ausführungen angezeigt.

Mehrere Pipelineausführungen abbrechen

Wenn Sie mehrere Pipeline-Ausführungen gleichzeitig abbrechen möchten, verwenden Sie die REST API oder das Vertex AI SDK für Python. Sie können Pipelineausführungen, die sich im selben Projekt und in derselben Region befinden, im Batch abbrechen.

REST

Wenn Sie mehrere laufende oder geplante Pipelineausführungen im Batch abbrechen möchten, senden Sie eine POST-Anfrage mit der Methode pipelineJobs.batchCancel.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• LOCATION: Die Region, in der sich die Pipelineausführungen befinden. Weitere Informationen zu den Regionen, in denen Vertex AI Pipelines verfügbar ist, finden Sie in der Anleitung zu Vertex AI-Standorten.
• PROJECT_ID: Das Google Cloud -Projekt, das die Pipelineausführungen enthält.
• PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: Die IDs der Pipelinejobs, die Sie abbrechen möchten. Sie finden die Job-ID in der Google Cloud Console auf der Seite Pipelines auf dem Tab Ausführungen.

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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:batchCancel" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.BatchCancelPipelineJobsOperationMetadata",
    "genericMetadata": {
      "createTime": "2025-05-25T16:11:21.011113Z",
      "updateTime": "2025-05-25T16:11:21.011113Z"
    }
  }
}

Python

Im folgenden Beispiel werden mehrere laufende oder geplante Pipelineausführungen mit der Methode PipelineJob.batch_cancel abgebrochen:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: Ihre Projekt-ID.
• LOCATION: Die Region, in der die Pipelineausführungen erstellt wurden.
• PROJECT_NUMBER: Die Projektnummer für Ihr Projekt. Sie finden diese Projektnummer in der Google Cloud Console.Weitere Informationen finden Sie unter Projektnamen, ‑nummer und ‑ID finden.
• PIPELINE_RUN_ID_1 und PIPELINE_JOB_ID_2: Die eindeutigen IDs der Pipelineausführungen, die Sie abbrechen möchten. Die IDs der Pipelineausführungen werden in der Google Cloud Console auf der Seite Pipelines auf dem Tab Ausführungen angezeigt.