파이프라인 실행 취소

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

파이프라인 실행 취소를 시작하면 파이프라인 실행 상태가 취소 중 으로 변경됩니다. 이 상태에서 Gemini Enterprise Agent Platform 파이프라인은 파이프라인의 나머지 모든 작업과 파이프라인 실행에 의해 호출된 모든 Cloud de Confiance by S3NS 서비스 및 리소스를 취소합니다. 이러한 모든 작업, 서비스, 리소스가 취소된 후에는 파이프라인 상태가 취소됨 으로 변경됩니다.

참고로, 취소된 파이프라인 실행은 삭제되지 않습니다. 취소한 후 파이프라인 실행을 삭제를 위한 옵션이 제공됩니다.

파이프라인 실행 취소

파이프라인 실행을 취소하려면 Cloud de Confiance 콘솔, REST API 또는 Agent Platform SDK for Python을 사용합니다.

콘솔

다음 안내에 따라 Cloud de Confiance 콘솔에서 진행 중인 파이프라인 실행을 취소합니다.

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

    실행으로 이동

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

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

REST

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

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

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

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: 파이프라인 실행이 포함된 Cloud de Confiance by S3NS 프로젝트
  • LOCATION: 파이프라인 실행이 있는 리전. Agent Platform 파이프라인을 사용할 수 있는 리전에 대한 자세한 내용은 Gemini Enterprise Agent Platform 위치 가이드를 참고하세요.
  • PIPELINE_RUN_ID PIPELINE_RUN_ID: 취소하려는 파이프라인 실행의 고유 ID. ID는Cloud de Confiance 콘솔의 파이프라인 페이지에 있는 실행 탭에 표시됩니다.

여러 파이프라인 실행 취소

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

REST

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

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

  • LOCATION: 파이프라인 실행이 있는 리전. Agent Platform 파이프라인을 사용할 수 있는 리전에 대한 자세한 내용은 Gemini Enterprise Agent Platform 위치 가이드를 참고하세요.
  • PROJECT_ID: 파이프라인 실행이 포함된 Cloud de Confiance by S3NS 프로젝트입니다.
  • PIPELINE_RUN_ID_1, PIPELINE_RUN_ID_2: 취소하려는 파이프라인 작업의 ID. 작업 ID는 Cloud de Confiance 콘솔의 파이프라인 페이지에 있는 실행 탭에서 확인할 수 있습니다.

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: 프로젝트의 프로젝트 번호. 이 프로젝트 번호는 Cloud de Confiance 콘솔에서 찾을 수 있습니다.자세한 내용은 프로젝트 이름, 번호, ID 찾기를 참고하세요.
  • PIPELINE_RUN_ID_1 및 PIPELINE_JOB_ID_2: 취소하려는 파이프라인 실행의 고유 ID. 파이프라인 실행 ID는 Cloud de Confiance 콘솔의 파이프라인 페이지에 있는 실행 탭에 표시됩니다.