Annuler les exécutions de pipeline

Si vous n'avez plus besoin d'une exécution de pipeline planifiée ou en cours, vous pouvez l'annuler. Si vous souhaitez annuler plusieurs exécutions de pipeline, vous pouvez les annuler par lot.

Lorsque vous lancez l'annulation d'une exécution de pipeline, l'état de l'exécution du pipeline passe à Annulation en cours. Dans cet état, Vertex AI Pipelines annule toutes les tâches restantes du pipeline, ainsi que tous les services et ressources Google Cloud appelés par l'exécution du pipeline. Une fois toutes ces tâches, tous ces services et toutes ces ressources annulés, l'état du pipeline passe à Annulé.

Notez qu'une exécution de pipeline annulée n'est pas supprimée. Vous pouvez supprimer l'exécution du pipeline après l'avoir annulée.

Annuler une exécution de pipeline

Pour annuler l'exécution d'un pipeline, utilisez la console Google Cloud , l'API REST ou le SDK Vertex AI pour Python.

Console

Suivez les instructions ci-dessous pour annuler une exécution de pipeline en cours depuis la console Google Cloud  :

1. Dans la section Vertex AI, accédez à l'onglet Exécutions de la page Pipelines.

   Accédez à "Exécutions".

2. Dans la colonne Exécuter, cliquez sur le nom de l'exécution de pipeline que vous souhaitez annuler.
3. Sur la page affichant les détails de l'exécution du pipeline, cliquez sur Arrêter. Cette option n'est disponible que si l'exécution du pipeline est à l'état En cours d'exécution.

Une fois que vous avez cliqué sur Arrêter, l'état du pipeline passe à Annulation en cours. Une fois que toutes les tâches, les services et les ressources Google Cloud Google Cloud appelés par l'exécution sont annulés, l'état passe à Annulé.

REST

Pour annuler une exécution de pipeline en cours ou planifiée, envoyez une requête POST à l'aide de la méthode pipelineJobs.cancel.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• LOCATION : région dans laquelle se trouve l'exécution du pipeline. Pour en savoir plus sur les régions dans lesquelles Vertex AI Pipelines est disponible, consultez le Guide des emplacements Vertex AI.
• PROJECT_ID : projet Google Cloud contenant l'exécution du pipeline.
• PIPELINE_RUN_ID : ID unique de l'exécution du pipeline que vous souhaitez annuler. L'ID d'exécution du pipeline s'affiche dans l'onglet Exécutions de la page Pipelines de la console Google Cloud .

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.

Python

Utilisez l'exemple suivant pour annuler une exécution de pipeline en cours ou planifiée à l'aide de la méthode PipelineJob.cancel :

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()

Remplacez les éléments suivants :

• PROJECT_ID : projet Google Cloud contenant l'exécution du pipeline.
• LOCATION : région dans laquelle se trouve l'exécution du pipeline. Pour en savoir plus sur les régions dans lesquelles Vertex AI Pipelines est disponible, consultez le Guide des emplacements Vertex AI.
• PIPELINE_RUN_ID avec l'ID unique de l'exécution du pipeline que vous souhaitez annuler. L'ID s'affiche dans l'onglet Exécutions de la page Pipelines de la consoleGoogle Cloud .

Annuler plusieurs exécutions de pipeline

Pour annuler plusieurs exécutions de pipeline simultanément, utilisez l'API REST ou le SDK Vertex AI pour Python. Vous pouvez annuler par lot les exécutions de pipelines qui se trouvent dans le même projet et la même région.

REST

Pour annuler par lot plusieurs exécutions de pipeline en cours ou planifiées, envoyez une requête POST à l'aide de la méthode pipelineJobs.batchCancel.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• LOCATION : région dans laquelle les exécutions de pipeline sont situées. Pour en savoir plus sur les régions dans lesquelles Vertex AI Pipelines est disponible, consultez le Guide des emplacements Vertex AI.
• PROJECT_ID : projet Google Cloud contenant les exécutions de pipeline.
• PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2 : ID des jobs de pipeline que vous souhaitez annuler. Vous trouverez l'ID du job dans l'onglet Exécutions de la page Pipelines de la console Google Cloud .

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Utilisez l'exemple suivant pour annuler plusieurs exécutions de pipeline en cours ou planifiées à l'aide de la méthode PipelineJob.batch_cancel :

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)

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• LOCATION : région dans laquelle les exécutions de pipeline ont été créées.
• PROJECT_NUMBER : numéro de votre projet. Vous trouverez ce numéro de projet dans la console Google Cloud .Pour en savoir plus, consultez Trouver le nom, le numéro et l'ID du projet.
• PIPELINE_RUN_ID_1 et PIPELINE_JOB_ID_2 : ID uniques des exécutions de pipeline que vous souhaitez annuler. Les ID d'exécution du pipeline s'affichent dans l'onglet Exécutions de la page Pipelines de la console Google Cloud .