Se non hai più bisogno di un'esecuzione della pipeline pianificata o in esecuzione, puoi annullarla. Se ci sono più esecuzioni della pipeline da annullare, puoi annullarle in batch.
Quando avvii l'annullamento di un'esecuzione della pipeline, lo stato dell'esecuzione della pipeline diventa Annullamento in corso. Durante questo stato, Vertex AI Pipelines annulla tutte le attività rimanenti nella pipeline e tutti i servizi e le risorse richiamati dall'esecuzione della pipeline. Google Cloud Una volta annullati tutti questi task, servizi e risorse, lo stato della pipeline cambia in Annullato.
Tieni presente che l'esecuzione di una pipeline annullata non viene eliminata. Dopo aver annullato l'esecuzione della pipeline, hai la possibilità di eliminarla.
Annulla un'esecuzione della pipeline
Per annullare l'esecuzione di una pipeline, utilizza la console Google Cloud , l'API REST o l'SDK Vertex AI per Python.
Console
Segui queste istruzioni per annullare l'esecuzione di una pipeline in corso dalla console Google Cloud :
- Nella sezione Vertex AI, vai alla scheda Esecuzioni nella pagina Pipeline.
- Nella colonna Esegui, fai clic sul nome dell'esecuzione della pipeline da annullare.
- Nella pagina che mostra i dettagli dell'esecuzione della pipeline, fai clic su Interrompi. Questa opzione è disponibile solo se l'esecuzione della pipeline è nello stato In esecuzione.
Dopo aver fatto clic su Interrompi, lo stato della pipeline cambia in Annullamento in corso. Dopo l'annullamento di tutte le attività della pipeline, dei servizi e delle risorse richiamate dall'esecuzione, lo stato cambia in Annullato. Google Cloud Google Cloud
REST
Per annullare un'esecuzione della pipeline in corso o pianificata, invia una richiesta POST
utilizzando il metodo pipelineJobs.cancel.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- LOCATION: la regione in cui si trova l'esecuzione della pipeline. Per saperne di più sulle regioni in cui è disponibile Vertex AI Pipelines, consulta la guida alle località di Vertex AI.
- PROJECT_ID: il Google Cloud progetto contenente l'esecuzione della pipeline.
- PIPELINE_RUN_ID: l'ID univoco dell'esecuzione della pipeline che vuoi annullare. L'ID esecuzione della pipeline viene visualizzato nella scheda Esecuzioni della pagina Pipeline nella console Google Cloud .
Metodo HTTP e URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID:cancel
Per inviare la richiesta, scegli una di queste opzioni:
curl
Esegui questo comando:
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
Esegui questo comando:
$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
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
Python
Utilizza il seguente esempio per annullare un'esecuzione della pipeline in corso o pianificata
utilizzando il metodo 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()
Sostituisci quanto segue:
- PROJECT_ID: il Google Cloud progetto contenente l'esecuzione della pipeline.
- LOCATION: la regione in cui si trova l'esecuzione della pipeline. Per saperne di più sulle regioni in cui è disponibile Vertex AI Pipelines, consulta la guida alle località di Vertex AI.
- PIPELINE_RUN_ID con l'ID univoco dell'esecuzione della pipeline che vuoi annullare. L'ID viene visualizzato nella scheda Esecuzioni della pagina Pipeline nella consoleGoogle Cloud .
Annulla più esecuzioni pipeline
Per annullare più esecuzioni della pipeline contemporaneamente, utilizza l'API REST o l'SDK Vertex AI per Python. Puoi annullare in batch le esecuzioni di pipeline che si trovano nello stesso progetto e nella stessa regione.
REST
Per annullare in batch più esecuzioni di pipeline in corso o pianificate, invia una richiesta POST utilizzando il metodo pipelineJobs.batchCancel.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- LOCATION: la regione in cui si trovano le esecuzioni della pipeline. Per saperne di più sulle regioni in cui è disponibile Vertex AI Pipelines, consulta la guida alle località di Vertex AI.
- PROJECT_ID: il Google Cloud progetto contenente le esecuzioni della pipeline.
- PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: gli ID dei job della pipeline che vuoi annullare. Puoi trovare l'ID job nella scheda Esecuzioni della pagina Pipeline nella console Google Cloud .
Metodo HTTP e URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchCancel
Corpo JSON della richiesta:
{
"names": [
"projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_1",
"projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_2"
]
}Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
ed esegui questo 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:batchCancel"
PowerShell
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$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
Dovresti ricevere una risposta JSON simile alla seguente:
{
"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
Utilizza il seguente esempio per annullare più esecuzioni di pipeline in corso o pianificate
utilizzando il metodo 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)
Sostituisci quanto segue:
- PROJECT_ID: il tuo ID progetto.
- LOCATION: la regione in cui sono state create le esecuzioni della pipeline.
- PROJECT_NUMBER: il numero di progetto. Puoi trovare questo numero di progetto nella console Google Cloud .Per saperne di più, consulta Trovare il nome, il numero e l'ID del progetto.
- PIPELINE_RUN_ID_1 e PIPELINE_JOB_ID_2: gli ID univoci delle esecuzioni della pipeline che vuoi annullare. Gli ID esecuzione della pipeline vengono visualizzati nella scheda Esecuzioni della pagina Pipeline nella console Google Cloud .