파이프라인 실행 취소

예약되었거나 실행 중인 파이프라인 실행이 더 이상 필요하지 않으면 취소할 수 있습니다. 취소할 파이프라인 실행이 여러 개 있는 경우 이러한 파이프라인 실행을 일괄 취소할 수 있습니다.

파이프라인 실행 취소를 시작하면 파이프라인 실행 상태가 Canceling으로 변경됩니다. 이 상태에서 Vertex AI Pipelines는 파이프라인의 나머지 모든 작업과 파이프라인 실행에 의해 호출된 모든 Google Cloud 서비스 및 리소스를 취소합니다. 이러한 모든 작업, 서비스, 리소스가 취소되면 파이프라인 상태가 취소됨으로 변경됩니다.

취소된 파이프라인 실행은 삭제되지 않습니다. 취소한 후 파이프라인 실행을 삭제할 수 있습니다.

파이프라인 실행 취소

파이프라인 실행을 취소하려면 Google Cloud 콘솔, REST API 또는 Vertex AI SDK for Python을 사용하세요.

콘솔

다음 안내에 따라 Google Cloud 콘솔에서 진행 중인 파이프라인 실행을 취소하세요.

  1. Vertex AI 섹션에서 파이프라인 페이지의 실행 탭으로 이동합니다.

    실행으로 이동

  2. 실행 열에서 취소하려는 파이프라인 실행의 이름을 클릭합니다.
  3. 파이프라인 실행 세부정보가 표시된 페이지에서 중지를 클릭합니다. 이 옵션은 파이프라인 실행이 Running 상태인 경우에만 사용할 수 있습니다.

중지를 클릭하면 파이프라인 상태가 취소 중으로 변경됩니다. 실행에 의해 호출된 모든 파이프라인 작업, Google Cloud 서비스,Google Cloud 리소스가 취소되면 상태가 Canceled로 변경됩니다.

REST

진행 중이거나 예약된 파이프라인 실행을 취소하려면 pipelineJobs.cancel 메서드를 사용하여 POST 요청을 전송합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • LOCATION: 파이프라인 실행이 있는 리전입니다. Vertex AI Pipelines을 사용할 수 있는 리전에 대한 자세한 내용은 Vertex AI 위치 가이드를 참조하세요.
  • PROJECT_ID: 파이프라인 실행이 포함된 Google Cloud 프로젝트입니다.
  • PIPELINE_RUN_ID: 취소할 파이프라인 실행의 고유 ID입니다. 파이프라인 실행 ID는 Google Cloud 콘솔의 파이프라인 페이지에 있는 실행 탭에 표시됩니다.

HTTP 메서드 및 URL: 

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

Python

다음 샘플을 사용하여 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()

다음을 바꿉니다.

  • PROJECT_ID: 파이프라인 실행이 포함된 Google Cloud 프로젝트입니다.
  • LOCATION: 파이프라인 실행이 있는 리전입니다. Vertex AI Pipelines을 사용할 수 있는 리전에 대한 자세한 내용은 Vertex AI 위치 가이드를 참조하세요.
  • PIPELINE_RUN_ID을 취소하려는 파이프라인 실행의 고유 ID로 바꿉니다. ID는Google Cloud 콘솔의 파이프라인 페이지에 있는 실행 탭에 표시됩니다.

여러 파이프라인 실행 취소

여러 파이프라인 실행을 동시에 취소하려면 REST API 또는 Vertex AI SDK for Python을 사용하세요. 동일한 프로젝트 및 리전에 있는 파이프라인 실행을 일괄 취소할 수 있습니다.

REST

진행 중이거나 예약된 여러 파이프라인 실행을 일괄 취소하려면 pipelineJobs.batchCancel 메서드를 사용하여 POST 요청을 전송하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • LOCATION: 파이프라인 실행이 있는 리전입니다. Vertex AI Pipelines을 사용할 수 있는 리전에 대한 자세한 내용은 Vertex AI 위치 가이드를 참조하세요.
  • PROJECT_ID: 파이프라인 실행이 포함된 Google Cloud 프로젝트입니다.
  • PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: 취소하려는 파이프라인 작업의 ID입니다. 작업 ID는 Google Cloud 콘솔의 파이프라인 페이지에 있는 실행 탭에서 찾을 수 있습니다.

HTTP 메서드 및 URL: 

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

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

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

다음과 비슷한 JSON 응답이 표시됩니다.

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

다음 샘플을 사용하여 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)

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID입니다.
  • LOCATION: 파이프라인 실행이 생성된 리전입니다.
  • PROJECT_NUMBER: 프로젝트의 프로젝트 번호입니다. 이 프로젝트 번호는 Google Cloud 콘솔에서 찾을 수 있습니다.자세한 내용은 프로젝트 이름, 번호, ID 찾기를 참고하세요.
  • PIPELINE_RUN_ID_1 및 PIPELINE_JOB_ID_2: 취소하려는 파이프라인 실행의 고유 ID입니다. 파이프라인 실행 ID는 Google Cloud 콘솔의 파이프라인 페이지에 있는 실행 탭에 표시됩니다.