리소스를 변경하는 Compute Engine API를 호출하면 Compute Engine이 작업 목록에 항목을 추가합니다. 예를 들어 데이터를 변형(변경)하는 VM을 업데이트하거나 VM 상태를 변경하는 호스트 이벤트가 발생하면 작업이 생성됩니다. 이 페이지에서는 Google Cloud 콘솔, Google Cloud CLI 또는 REST를 사용하여 Compute Engine 작업 목록을 확인하는 방법을 설명합니다.
작업을 완료하는 데 시간이 오래 걸려서 검토 중 완료되지 않은 작업이 발견될 수 있다는 점에 주의하세요. 완료되지 않은 작업의 최종 상태를 보기 위해 작업을 반복적으로 확인하는 것은 권장되지 않습니다. 대신 작업이 완료될 때까지 기다려야 합니다.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.
이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.
콘솔
Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스할 때는 인증을 설정할 필요가 없습니다.
gcloud
-
Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다.
gcloud init
- 기본 리전 및 영역을 설정합니다.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
-
작업 보관 기간
작업을 쿼리할 때는 완료된 작업이 일정 기간 이후에 데이터베이스에서 자동으로 삭제된다는 것에 주의하세요.
Compute Engine은 최소 보관 기간 1시간부터 최대 보관 기간 14일까지 완료된 작업을 보관합니다. 프로젝트에 완료된 작업의 보관 기간이 1시간 이상 관측되는 경우가 많지만 이러한 추가적인 보관 기간에 의존하는 것은 권장되지 않습니다.
사용자가 Operations.delete 메서드를 통해 삭제한 작업에는 보관 기간이 적용되지 않습니다.
작업 보기
프로젝트의 작업 목록을 보려면 다음 단계를 수행하세요.
Console
Google Cloud Console에서 작업 페이지로 이동합니다.
작업에 대한 자세한 내용을 보려면 작업 요약을 클릭합니다. 예를 들어
my-instanceVM의 마이그레이션 세부정보를 보려면 자동으로 인스턴스 마이그레이션 작업을 클릭합니다.
gcloud
gcloud compute를 사용하여 프로젝트의 작업 목록을 보려면 operations list 하위 명령어를 사용합니다.
지정된 영역의 작업 목록을 보려면 --filter 플래그를 추가합니다.
gcloud compute operations list --filter="zone:(ZONE)"
ZONE을 작업 목록을 보려는 영역으로 바꿉니다. 예를 들어 us-cental1-c의 작업 목록을 보려면 다음 명령어를 실행하세요.
gcloud compute operations list --filter="zone:(us-central1-c)"
출력은 다음과 비슷합니다.
NAME TYPE TARGET HTTP_STATUS STATUS TIMESTAMP
systemevent-1543845145000... compute.instances.migrateOnHostMaintenance us-central1-c/instances/my-instance 200 DONE 2018-12-03T05:52:25.000-08:00
REST
작업에 대한 API 요청을 전역, 리전, 영역 수준에서 지정해야 합니다. 라이브 마이그레이션, VM 중지, 자동 다시 시작은 모두 영역 수준 작업입니다.
영역 작업의 경우 zoneOperations.list 메서드에 대한 GET 요청을 수행합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations
다음을 바꿉니다.
PROJECT_ID: 이 요청의 프로젝트 ID입니다.ZONE: 이 요청의 영역입니다.
요청 본문을 비워 둡니다.
다음은 영역 작업 요청의 샘플 출력입니다. 이 출력에는 호스트 마이그레이션의 세부정보가 표시됩니다.
{
"kind": "compute#operation",
"id": "3216798767364213712",
"name": "systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b",
"zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c",
"operationType": "compute.instances.migrateOnHostMaintenance",
"targetLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/instances/my-instance",
"targetId": "3070988523247098025",
"status": "DONE",
"statusMessage": "Instance migrated during Compute Engine maintenance.",
"user": "system",
"progress": 100,
"insertTime": "2018-12-03T05:52:25.000-08:00",
"startTime": "2018-12-03T05:52:25.000-08:00",
"endTime": "2018-12-03T05:52:25.000-08:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/operations/systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b"
}