컴퓨팅 인스턴스의 호스트 유지보수 정책 설정

이 문서에서는 Compute Engine 인스턴스의 호스트 유지보수 정책을 설정하여 호스트 이벤트 중에 인스턴스의 동작을 결정하는 방법을 설명합니다. 호스트 유지보수 정책에 관한 자세한 내용은 호스트 유지보수 정책을 참조하세요.

호스트 유지보수 정책은 인스턴스가 실행 중인 호스트에 유지보수가 필요하거나 오류가 발생할 때 인스턴스가 응답하는 방식을 결정합니다. 인스턴스의 호스트 유지보수 정책을 구성하면 다음 작업을 할 수 있습니다.

  • 다운타임 최소화

  • 데이터 손실 방지

제한사항

호스트 유지보수 정책에는 다음과 같은 제한사항이 적용됩니다.

  • E2 머신 유형을 사용하는 가상 머신 인스턴스는 Spot VM 또는 선점형 VM이 아닌 한 호스트 유지보수 이벤트 중에만 라이브 마이그레이션할 수 있습니다.

  • 다음 인스턴스는 호스트 유지보수 이벤트 중에만 중지할 수 있습니다.

  • 스팟 VM 및 선점형 VM은 호스트 오류 또는 프로그래밍된 중지 후 자동으로 다시 시작할 수 없습니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

      로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

필요한 역할

컴퓨팅 인스턴스의 호스트 유지보수 정책을 설정하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자(v1)(roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 컴퓨팅 인스턴스의 호스트 유지보수 정책을 설정하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

컴퓨팅 인스턴스의 호스트 유지보수 정책을 설정하려면 다음 권한이 필요합니다.

  • 인스턴스를 만들려면 다음 안내를 따르세요.
    • 프로젝트에 대한 compute.instances.create 권한
    • 커스텀 이미지를 사용하여 VM 만들기: 이미지에 대한 compute.images.useReadOnly 권한
    • 스냅샷을 사용하여 VM 만들기: 스냅샷에 대한 compute.snapshots.useReadOnly 권한
    • 인스턴스 템플릿을 사용하여 VM 만들기: 인스턴스 템플릿에 대한 compute.instanceTemplates.useReadOnly 권한
    • VM에 기존 네트워크 할당: 프로젝트에 대한 compute.networks.use 권한
    • VM의 고정 IP 주소 지정: 프로젝트에 대한 compute.addresses.use 권한
    • 기존 네트워크 사용 시 VM에 외부 IP 주소 할당: 프로젝트에 대한 compute.networks.useExternalIp 권한
    • VM의 서브넷 지정: 프로젝트 또는 선택한 서브넷에 대한 compute.subnetworks.use 권한
    • VPC 네트워크를 사용할 때 VM에 외부 IP 주소 할당: 프로젝트 또는 선택한 서브넷에 대한 compute.subnetworks.useExternalIp 권한
    • VM에 VM 인스턴스 메타데이터 설정: 프로젝트에 대한 compute.instances.setMetadata 권한
    • VM에 태그 설정: VM에 대한 compute.instances.setTags 권한
    • VM에 라벨 설정: VM에 대한 compute.instances.setLabels 권한
    • VM에 사용할 서비스 계정 설정: VM에 대한 compute.instances.setServiceAccount 권한
    • VM의 새 디스크 만들기: 프로젝트에 대한 compute.disks.create 권한
    • 기존 디스크를 읽기 전용 또는 읽기-쓰기 모드로 연결: 디스크에 대한 compute.disks.use 권한
    • 기존 디스크를 읽기 전용 모드로 연결: 디스크에 대한 compute.disks.useReadOnly 권한
  • 인스턴스 템플릿 만들기: 프로젝트에 대한 compute.instanceTemplates.create 권한
  • 인스턴스의 호스트 유지보수 정책 업데이트: 인스턴스에 대한 compute.instances.setScheduling 권한

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

사용 가능한 호스트 유지보수 속성

예약된 유지보수 또는 예기치 않은 호스트 이벤트 중에 컴퓨팅 인스턴스가 작동하는 방식을 맞춤설정할 수 있습니다. 별도로 지정하지 않는 한 Compute Engine은인스턴스, 일괄 인스턴스 또는 인스턴스 템플릿을 만들 때 기본 설정을 사용합니다.

다음 호스트 유지보수 속성을 구성할 수 있습니다.

  • 유지보수 동작(onHostMaintenance): 호스트에서 유지보수 이벤트가 발생해 인스턴스가 재시작될 수 있는 경우 인스턴스에 발생하는 상황입니다. 이 속성은 다음 중 하나로 설정할 수 있습니다.

    • 마이그레이션: Compute Engine에서 인스턴스를 다른 호스트로 자동으로 라이브 마이그레이션합니다. 이는 스팟 VM 및 선점형 VM을 제외한 모든 유형의 인스턴스에 대한 기본 설정입니다.

    • 종료: Compute Engine에서 인스턴스를 중지합니다. 이는 스팟 VM 또는 선점형 VM의 기본 설정이며, vCPU가 88개 이상인 Z3 인스턴스, 베어메탈 인스턴스, GPU 또는 TPU가 연결된 인스턴스에만 지원되는 설정입니다.

  • 자동 다시 시작(automaticRestart): 인스턴스가 비정상 종료되었을 경우나 유지보수 이벤트와 같이 프로그래밍된 이유로 Compute Engine에서 인스턴스가 중지된 경우 인스턴스를 다시 시작할지 여부를 결정합니다. 이 속성은 다음 중 하나로 설정할 수 있습니다.

    • 사용: Compute Engine에서 인스턴스를 자동으로 다시 시작합니다. 이는 스팟 VM 및 선점형 VM을 제외한 모든 유형의 인스턴스에 대한 기본 설정입니다. 이 설정은 다음과 같이 지정합니다.

      • Google Cloud 콘솔의 고급 창 자동으로 다시 시작 목록에서 사용(권장)을 선택합니다.

      • Google Cloud CLI의 경우 --restart-on-failure 플래그를 사용합니다.

      • REST의 경우 automaticRestart 필드를 true로 설정합니다.

    • 사용 안함: Compute Engine이 인스턴스를 다시 시작하지 않습니다. 스팟 VM 또는 선점형 VM의 기본 설정입니다. 이 설정은 다음과 같이 지정합니다.

      • Google Cloud 콘솔의 고급 창에 있는 자동으로 다시 시작 목록에서 사용 안함을 선택합니다.

      • gcloud CLI의 경우 --no-restart-on-failure 플래그를 사용합니다.

      • REST의 경우 automaticRestart 필드를 false로 설정합니다.

  • 로컬 SSD 데이터 복구 제한 시간(localSsdRecoveryTimeout): 이 설정은 로컬 SSD 디스크가 연결된 인스턴스에만 적용됩니다. 호스트 오류 후 Compute Engine에서 로컬 SSD 디스크의 데이터를 복구하기 위해 대기하는 시간을 결정합니다. 기본적으로 이 속성은 설정되지 않습니다. 이 속성은 다음 중 하나로 설정할 수 있습니다.

    • 설정되지 않음: Compute Engine은 기본 대기 시간을 사용합니다.

      • Z3 VM: 6시간

      • 기타 모든 유형의 인스턴스: 1시간

    • 0~168 사이의 정수: 대기할 시간입니다. 이 속성을 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않고 인스턴스를 즉시 다시 시작합니다.

  • 호스트 오류 제한 시간(hostErrorTimeoutSeconds): 이 속성은 Compute Engine이 응답하지 않는 인스턴스를 다시 시작하기 위해 대기하는 시간을 결정합니다. 인스턴스가 응답하지 않기 전에 이 설정을 구성해야 합니다. 인스턴스가 응답하지 않는 상태에서 복구될 만큼 긴 제한 시간을 사용합니다. 이 속성은 다음 중 하나로 설정할 수 있습니다.

    • 설정되지 않음: Compute Engine이 최대 330초(5분 30초) 동안 대기합니다. 이는 모든 유형의 인스턴스에 대한 기본 설정입니다.

    • 90~330 사이의 정수: 대기 시간(초)이며 30초 단위로 증가합니다.

인스턴스의 호스트 유지보수 정책 설정

기본적으로 컴퓨팅 인스턴스는 호스트 유지보수 정책에 기본 설정을 사용합니다. 이러한 설정을 맞춤설정하려면 다음 방법 중 하나를 사용하세요.

기존 인스턴스의 정책 설정

기존 인스턴스의 호스트 유지보수 정책을 변경하기 전에 다음 사항을 확인하세요.

  • 다음 인스턴스 유형의 유지보수 동작(onHostMaintenance)은 변경할 수 없습니다.

  • 호스트 오류 또는 프로그래밍된 중지 후 자동으로 다시 시작되도록 스팟 VM 또는 선점형 VM을 구성할 수는 없습니다.

로컬 SSD 디스크가 연결된 인스턴스에서 로컬 SSD 데이터 복구 제한 시간을 변경하려면 gcloud CLI 또는 REST API를 사용하세요. 그렇지 않으면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스로 이동

  2. 이름 열에서 업데이트할 인스턴스의 이름을 클릭합니다. 인스턴스의 세부정보를 제공하는 페이지가 표시됩니다.

  3. 수정을 클릭합니다. 인스턴스 속성을 수정할 수 있는 페이지가 표시됩니다.

  4. 관리 섹션에서 다음 중 하나 이상을 수행할 수 있습니다.

    • 유지보수 이벤트 중에 동작을 변경하려면 호스트 유지보수 시 목록에서 다른 옵션을 선택합니다.

    • 응답하지 않는 인스턴스를 다시 시작하기 전에 제한 시간을 변경하려면 호스트 오류 제한 시간 목록에서 다른 옵션을 선택합니다.

    • 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 다시 시작할지 여부를 변경하려면 자동으로 다시 시작 목록에서 다른 옵션을 선택합니다.

  5. 저장을 클릭합니다.

gcloud

기존 인스턴스의 호스트 유지보수 정책을 변경하려면 gcloud compute instances set-scheduling 명령어와 함께 다음 플래그 중 하나 이상을 사용합니다.

  • 호스트 유지보수 동작을 변경하려면 --maintenance-policy 플래그를 포함합니다.

  • 자동 재시작 동작을 변경하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 --restart-on-failure 플래그를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 --no-restart-on-failure 플래그를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 변경하려면 --local-ssd-recovery-timeout 플래그를 포함합니다.

  • 호스트 오류 제한 시간을 변경하려면 --host-error-timeout-seconds 플래그를 포함합니다.

예를 들어 호스트 유지보수 동작을 변경하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 변경하고, 호스트 오류 제한 시간을 변경하려면 다음 명령어를 실행합니다.

gcloud compute instances set-scheduling INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

다음을 바꿉니다.

  • INSTANCE_NAME: 인스턴스의 이름.

  • ERROR_DETECTION_TIMEOUT: Compute Engine이 응답하지 않는 인스턴스를 다시 시작하기까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다.

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • ZONE: 인스턴스가 있는 영역입니다.

REST

기존 인스턴스의 호스트 유지보수 정책을 변경하려면 instances.setScheduling 메서드에 POST 요청을 보냅니다. 요청 본문에 다음 필드 중 하나 이상을 포함합니다.

  • 호스트 유지보수 동작을 변경하려면 onHostMaintenance 필드를 포함합니다.

  • 자동 재시작 동작을 변경하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 automaticRestart 필드를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 automaticRestart 필드를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 변경하려면 localSsdRecoveryTimeout 필드를 포함합니다.

  • 호스트 오류 제한 시간을 변경하려면 hostErrorTimeoutSeconds 필드를 포함합니다.

예를 들어 호스트 유지보수 동작을 변경하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 변경하고, 호스트 오류 제한 시간을 변경하려면 다음과 같이 요청합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

{
  "automaticRestart": AUTOMATIC_RESTART,
  "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
  "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
  "onHostMaintenance": "MAINTENANCE_POLICY"
}

다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 있는 프로젝트의 ID입니다.

  • ZONE: 인스턴스가 있는 영역입니다.

  • INSTANCE_NAME: 인스턴스의 이름.

  • AUTOMATIC_RESTART: 인스턴스가 비정상 종료되거나 Compute Engine에서 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스의 자동 다시 시작 동작입니다. 다음 값 중 하나를 지정합니다.

    • Compute Engine에서 인스턴스를 자동으로 다시 시작하도록 허용하려면 true를 지정합니다.

    • 자동 다시 시작을 방지하려면 false를 지정합니다.

  • ERROR_DETECTION_TIMEOUT: 응답하지 않는 인스턴스를 다시 시작하기 전까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다.

인스턴스를 만드는 동안 정책 설정

컴퓨팅 인스턴스를 만들 때 인스턴스의 호스트 유지보수 정책을 설정할 수 있습니다.

로컬 SSD 디스크가 연결된 인스턴스를 만드는 동안 로컬 SSD 데이터 복구 제한 시간을 설정하려면 gcloud CLI 또는 REST API를 사용하세요. 그렇지 않으면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.

    인스턴스 만들기로 이동

  2. 이름 필드에 인스턴스의 이름을 입력합니다.

  3. 리전 및 영역 필드에서 인스턴스를 만들 리전과 영역을 지정합니다.

  4. 인스턴스의 머신 유형을 지정합니다.

  5. 탐색 메뉴에서 고급을 클릭합니다.

  6. 프로비저닝 모델 섹션에서 VM 프로비저닝 모델 고급 설정을 펼친 후 다음 중 하나 이상을 수행합니다.

    • 유지보수 이벤트 중에 동작을 설정하려면 호스트 유지보수 시 목록에서 다음 옵션 중 하나를 선택합니다.

      • 호스트 유지보수 이벤트 중에 인스턴스를 마이그레이션하려면 VM 인스턴스 마이그레이션(권장)을 선택합니다.

      • 호스트 유지보수 이벤트 중에 인스턴스를 중지하려면 VM 인스턴스 종료를 선택합니다.

    • 응답하지 않는 인스턴스를 다시 시작하기 전에 제한 시간을 설정하려면 호스트 오류 제한 시간 목록에서 다음 옵션 중 하나를 선택합니다.

      • 호스트 오류 제한 시간을 지정하지 않으려면 지정되지 않음(기본값)을 선택합니다.

      • 호스트 오류 제한 시간을 지정하려면 사용 가능한 옵션 중 하나(최대 5분 30초)를 선택합니다.

    • 인스턴스가 비정상 종료되거나 중지된 경우 인스턴스를 다시 시작할지 여부를 설정하려면 자동으로 다시 시작 목록에서 다음 옵션 중 하나를 선택합니다.

      • 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하려면 사용(권장)을 선택합니다.

      • 호스트 오류 또는 프로그래밍된 중지 후 인스턴스가 자동으로 다시 시작되지 않도록 하려면 사용 안함을 선택합니다.

  7. 만들기를 클릭합니다.

gcloud

인스턴스를 만들 때 인스턴스의 호스트 유지보수 정책을 설정하려면 gcloud compute instances create 명령어와 함께 다음 플래그 중 하나 이상을 사용합니다.

  • 호스트 유지보수 동작을 설정하려면 --maintenance-policy 플래그를 포함합니다.

  • 자동 재시작 동작을 설정하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 --restart-on-failure 플래그를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 --no-restart-on-failure 플래그를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 설정하려면 --local-ssd-recovery-timeout 플래그를 포함합니다.

  • 호스트 오류 제한 시간을 설정하려면 --host-error-timeout-seconds 플래그를 포함합니다.

예를 들어 호스트 유지보수 동작을 설정하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 설정하고, 호스트 오류 제한 시간을 설정하려면 다음 명령어를 실행합니다.

gcloud compute instances create INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

다음을 바꿉니다.

  • INSTANCE_NAME: 인스턴스 이름입니다.

  • ERROR_DETECTION_TIMEOUT: 응답하지 않는 인스턴스를 다시 시작하기 전까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • MACHINE_TYPE: 사용할 머신 유형.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다. 라이브 마이그레이션을 지원하지 않는 스팟 VM, 선점형 VM 또는 인스턴스를 만드는 경우 TERMINATE만 사용할 수 있습니다.

  • ZONE: 인스턴스를 만들 영역입니다.

REST

인스턴스를 만들 때 인스턴스의 호스트 유지보수 정책을 설정하려면 instances.insert 메서드에 POST 요청을 보냅니다. 요청 본문의 scheduling 필드에 다음 필드 중 하나 이상을 포함합니다.

  • 호스트 유지보수 동작을 설정하려면 onHostMaintenance 필드를 포함합니다.

  • 자동 재시작 동작을 설정하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 automaticRestart 필드를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 automaticRestart 필드를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 설정하려면 localSsdRecoveryTimeout 필드를 포함합니다.

  • 호스트 오류 제한 시간을 설정하려면 hostErrorTimeoutSeconds 필드를 포함합니다.

예를 들어 호스트 유지보수 동작을 설정하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 설정하고, 호스트 오류 제한 시간을 설정하려면 다음과 같이 요청합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "automaticRestart": AUTOMATIC_RESTART,
    "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
    "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

다음을 바꿉니다.

  • PROJECT_ID: 인스턴스를 만들 프로젝트의 ID입니다.

  • ZONE: 인스턴스를 만들 영역입니다.

  • INSTANCE_NAME: 인스턴스 이름입니다.

  • MACHINE_TYPE: 사용할 머신 유형.

  • IMAGE_PROJECT: 이미지가 포함된 이미지 프로젝트입니다(예: debian-cloud). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.

  • IMAGE: 다음 중 하나를 지정합니다.

    • OS 이미지의 특정 버전입니다(예: debian-12-bookworm-v20240617).

    • 이미지 계열이며 형식은 family/IMAGE_FAMILY여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어 family/debian-12를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.

  • AUTOMATIC_RESTART: 인스턴스가 비정상 종료되거나 Compute Engine에서 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스의 자동 다시 시작 동작입니다. 다음 값 중 하나를 지정합니다.

    • Compute Engine에서 인스턴스를 자동으로 다시 시작하도록 허용하려면 true를 지정합니다.

    • 자동 다시 시작을 방지하려면 false를 지정합니다.

  • ERROR_DETECTION_TIMEOUT: 응답하지 않는 인스턴스를 다시 시작하기 전까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다. 라이브 마이그레이션을 지원하지 않는 스팟 VM 또는 인스턴스를 만드는 경우 TERMINATE만 사용할 수 있습니다.

인스턴스 만들기에 관한 자세한 내용은 Compute Engine 인스턴스 만들기 및 시작을 참조하세요.

인스턴스를 일괄 생성하는 동안 정책 설정

인스턴스를 일괄로 만들 때 호스트 유지보수 정책을 설정하려면 다음 옵션 중 하나를 선택합니다.

gcloud

인스턴스를 일괄로 만들면서 호스트 유지보수 정책을 설정하려면 다음 플래그 중 하나 이상과 함께 gcloud compute instances bulk create 명령어를 사용합니다.

  • 호스트 유지보수 동작을 설정하려면 --maintenance-policy 플래그를 포함합니다.

  • 자동 재시작 동작을 설정하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 --restart-on-failure 플래그를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 --no-restart-on-failure 플래그를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 설정하려면 --local-ssd-recovery-timeout 플래그를 포함합니다.

  • 호스트 오류 제한 시간을 설정하려면 --host-error-timeout-seconds 플래그를 포함합니다.

예를 들어 호스트 유지보수 동작을 설정하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 설정하고, 호스트 오류 제한 시간을 설정하려면 다음 명령어를 실행합니다. 다음 예시에서는 단일 영역에 인스턴스를 만들고 인스턴스의 이름 패턴을 지정합니다.

gcloud compute instances bulk create \
    --count=COUNT \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --restart-on-failure \
    --zone=ZONE

다음을 바꿉니다.

  • COUNT: 만들 인스턴스 수입니다.

  • ERROR_DETECTION_TIMEOUT: 응답하지 않는 인스턴스를 다시 시작하기 전까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • MACHINE_TYPE: 사용할 머신 유형.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다. 라이브 마이그레이션을 지원하지 않는 스팟 VM, 선점형 VM 또는 인스턴스를 만드는 경우 TERMINATE만 사용할 수 있습니다.

  • NAME_PATTERN: 인스턴스의 이름 패턴입니다. 인스턴스 이름에서 일련의 숫자를 바꾸려면 해시(#) 문자 시퀀스를 사용합니다. 예를 들어 이름 패턴에 instance-#을 사용하면 이름이 instance-1, instance-2로 시작하고 COUNT에 지정된 인스턴스 수까지 이어지는 인스턴스가 생성됩니다.

  • ZONE: 인스턴스를 만들 영역입니다.

REST

인스턴스를 일괄로 만들 때 호스트 유지보수 정책을 설정하려면 POST 요청을 instances.bulkInsert 메서드에 보냅니다. 요청 본문의 scheduling 필드에 다음 필드 중 하나 이상을 포함합니다.

  • 호스트 유지보수 동작을 설정하려면 onHostMaintenance 필드를 포함합니다.

  • 자동 재시작 동작을 설정하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 automaticRestart 필드를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 automaticRestart 필드를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 설정하려면 localSsdRecoveryTimeout 필드를 포함합니다.

  • 호스트 오류 제한 시간을 설정하려면 hostErrorTimeoutSeconds 필드를 포함합니다.

예를 들어 호스트 유지보수 동작을 설정하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 설정하고, 호스트 오류 제한 시간을 설정하려면 다음과 같이 요청합니다. 다음 예시에서는 단일 영역에 인스턴스를 만들고 인스턴스의 이름 패턴을 지정합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

다음을 바꿉니다.

  • PROJECT_ID: 인스턴스를 만들 프로젝트의 ID입니다.

  • ZONE: 인스턴스를 만들 영역입니다.

  • COUNT: 만들 인스턴스 수입니다.

  • NAME_PATTERN: 인스턴스 이름 패턴입니다. 인스턴스 이름에서 일련의 숫자를 바꾸려면 해시(#) 문자 시퀀스를 사용합니다. 예를 들어 이름 패턴에 instance-#을 사용하면 이름이 instance-1, instance-2로 시작하고 COUNT에 지정된 인스턴스 수까지 이어지는 인스턴스가 생성됩니다.

  • MACHINE_TYPE: 사용할 머신 유형.

  • IMAGE_PROJECT: 이미지가 포함된 이미지 프로젝트입니다(예: debian-cloud). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.

  • IMAGE: 다음 중 하나를 지정합니다.

    • OS 이미지의 특정 버전입니다(예: debian-12-bookworm-v20240617).

    • 이미지 계열이며 형식은 family/IMAGE_FAMILY여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어 family/debian-12를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.

  • AUTOMATIC_RESTART: 인스턴스가 비정상 종료되거나 Compute Engine에서 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스의 자동 다시 시작 동작입니다. 다음 값 중 하나를 지정합니다.

    • Compute Engine에서 인스턴스를 자동으로 다시 시작하도록 허용하려면 true를 지정합니다.

    • 자동 다시 시작을 방지하려면 false를 지정합니다.

  • ERROR_DETECTION_TIMEOUT: 응답하지 않는 인스턴스를 다시 시작하기 전까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다. 라이브 마이그레이션을 지원하지 않는 스팟 VM, 선점형 VM 또는 인스턴스를 만드는 경우 TERMINATE만 사용할 수 있습니다.

인스턴스를 일괄로 만드는 방법에 대한 자세한 내용은 VM 일괄 생성을 참조하세요.

인스턴스 템플릿을 만드는 동안 정책 설정

인스턴스 템플릿을 만드는 동안 호스트 유지보수 정책을 설정할 수 있습니다. 템플릿을 사용하여 만드는 모든 컴퓨팅 인스턴스는 템플릿에 지정된 호스트 유지보수 정책을 상속합니다.

로컬 SSD 디스크를 지정하는 인스턴스 템플릿을 만들 때 로컬 SSD 데이터 복구 제한 시간을 설정하려면 gcloud CLI 또는 REST API를 사용하세요. 그렇지 않으면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 인스턴스 템플릿 페이지로 이동합니다.

    인스턴스 템플릿으로 이동

  2. 인스턴스 템플릿 만들기를 클릭합니다. 인스턴스 템플릿 만들기 페이지가 표시됩니다.

  3. 이름 필드에 인스턴스 템플릿의 이름을 입력합니다.

  4. 위치 섹션에서 다음 옵션 중 하나를 선택합니다.

    • 리전 인스턴스 템플릿을 만들려면 리전(권장)을 선택한 후 템플릿을 만들 리전을 선택합니다.

    • 전역 인스턴스 템플릿을 만들려면 전역을 선택합니다.

  5. 머신 구성 섹션에서 인스턴스 템플릿의 머신 유형을 지정합니다.

  6. 프로비저닝 모델 섹션에서 VM 프로비저닝 모델 고급 설정을 펼친 후 다음 중 하나 이상을 수행합니다.

    • 유지보수 이벤트 중에 동작을 변경하려면 호스트 유지보수 시 목록에서 다음 옵션 중 하나를 선택합니다.

      • 호스트 유지보수 이벤트 중에 인스턴스를 마이그레이션하려면 VM 인스턴스 마이그레이션(권장)을 선택합니다.

      • 호스트 유지보수 이벤트 중에 인스턴스를 중지하려면 VM 인스턴스 종료를 선택합니다.

    • 응답하지 않는 인스턴스를 다시 시작하기 전에 제한 시간을 변경하려면 호스트 오류 제한 시간 목록에서 다음 옵션 중 하나를 선택합니다.

      • 호스트 오류 제한 시간을 지정하지 않으려면 지정되지 않음(기본값)을 선택합니다.

      • 호스트 오류 제한 시간을 지정하려면 사용 가능한 옵션 중 하나(최대 5분 30초)를 선택합니다.

    • 인스턴스가 비정상 종료되거나 중지된 경우 인스턴스를 다시 시작할지 여부를 변경하려면 자동으로 다시 시작 목록에서 다음 옵션 중 하나를 선택합니다.

      • 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하려면 사용(권장)을 선택합니다.

      • 호스트 오류 또는 프로그래밍된 중지 후 인스턴스가 자동으로 다시 시작되지 않도록 하려면 사용 안함을 선택합니다.

  7. 만들기를 클릭합니다.

gcloud

인스턴스 템플릿을 만들 때 호스트 유지보수 정책을 설정하려면 gcloud compute instance-templates create 명령어와 함께 다음 플래그 중 하나 이상을 사용합니다.

  • 호스트 유지보수 동작을 설정하려면 onHostMaintenance 필드를 포함합니다.

  • 자동 재시작 동작을 설정하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 automaticRestart 필드를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 automaticRestart 필드를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 설정하려면 localSsdRecoveryTimeout 필드를 포함합니다.

  • 호스트 오류 제한 시간을 설정하려면 hostErrorTimeoutSeconds 필드를 포함합니다.

예를 들어 호스트 유지보수 동작을 설정하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 설정하고, 호스트 오류 제한 시간을 설정하려면 다음 명령어를 실행합니다. 다음 예시에서는 리전 인스턴스 템플릿도 만듭니다. 전역 인스턴스 템플릿을 만들려면 --instance-template-region 플래그 없이 동일한 명령어를 사용합니다.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --instance-template-region=REGION \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure

다음을 바꿉니다.

  • INSTANCE_TEMPLATE_NAME: 인스턴스 템플릿의 이름입니다.

  • ERROR_DETECTION_TIMEOUT: 응답하지 않는 인스턴스를 다시 시작하기 전까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • REGION: 인스턴스 템플릿을 만들 리전

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • MACHINE_TYPE: 사용할 머신 유형.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다. 인스턴스 템플릿에서 라이브 마이그레이션을 지원하지 않는 스팟 VM, 선점형 VM 또는 인스턴스 유형을 지정하는 경우 TERMINATE만 사용할 수 있습니다.

REST

인스턴스 템플릿을 만들 때 호스트 유지보수 정책을 설정하려면 다음 메서드 중 하나로 POST 요청을 실행합니다.

요청 본문의 scheduling 필드에 다음 필드 중 하나 이상을 포함합니다.

  • 호스트 유지보수 동작을 설정하려면 onHostMaintenance 필드를 포함합니다.

  • 자동 재시작 동작을 설정하려면 다음 중 하나를 실행합니다.

    • 인스턴스를 자동으로 다시 시작하려면 automaticRestart 필드를 포함합니다.

    • 인스턴스가 자동으로 다시 시작되지 않도록 하려면 automaticRestart 필드를 포함합니다.

  • 인스턴스에 로컬 SSD 디스크가 연결된 경우 로컬 SSD 데이터 복구 제한 시간을 설정하려면 localSsdRecoveryTimeout 필드를 포함합니다.

  • 호스트 오류 제한 시간을 설정하려면 hostErrorTimeoutSeconds 필드를 포함합니다.

예를 들어 호스트 유지보수 동작을 설정하고, 호스트 오류 또는 프로그래밍된 중지 후 인스턴스를 자동으로 다시 시작하고, 로컬 SSD 데이터 복구 제한 시간을 설정하고, 호스트 오류 제한 시간을 설정하려면 다음과 같이 요청합니다. 다음 예시에서는 리전 인스턴스 템플릿도 만듭니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

다음을 바꿉니다.

  • PROJECT_ID: 인스턴스 템플릿을 만들 프로젝트의 ID

  • REGION: 인스턴스 템플릿을 만들 리전

  • INSTANCE_TEMPLATE_NAME: 인스턴스 템플릿의 이름

  • IMAGE_PROJECT: 이미지가 포함된 이미지 프로젝트(예: debian-cloud). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.

  • IMAGE: 다음 중 하나를 지정합니다.

    • OS 이미지의 특정 버전입니다(예: debian-12-bookworm-v20240617).

    • 이미지 계열이며 형식은 family/IMAGE_FAMILY여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어 family/debian-12를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.

  • MACHINE_TYPE: 사용할 머신 유형.

  • AUTOMATIC_RESTART: 인스턴스가 비정상 종료되거나 Compute Engine에서 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스의 자동 다시 시작 동작입니다. 다음 값 중 하나를 지정합니다.

    • Compute Engine에서 인스턴스를 자동으로 다시 시작하도록 허용하려면 true를 지정합니다.

    • 자동 다시 시작을 방지하려면 false를 지정합니다.

  • ERROR_DETECTION_TIMEOUT: 응답하지 않는 인스턴스를 다시 시작하기 전까지의 시간(초)입니다. 값은 90(90초)과 330(330초 또는 5분 30초) 사이여야 합니다. 30초 단위로만 설정할 수 있습니다.

  • LOCAL_SSD_RECOVERY_TIMEOUT: 연결된 로컬 SSD 디스크에서 데이터를 복구하는 데 걸리는 시간입니다. 값은 0(0시간)과 168(168시간 또는 7일) 사이여야 합니다. 이 필드를 0으로 설정하면 Compute Engine에서 로컬 SSD 데이터를 복구하지 않습니다.

  • MAINTENANCE_POLICY: 인스턴스의 유지보수 동작입니다. 값은 TERMINATE 또는 MIGRATE일 수 있습니다. 인스턴스 템플릿에서 라이브 마이그레이션을 지원하지 않는 스팟 VM, 선점형 VM 또는 인스턴스 유형을 지정하는 경우 TERMINATE만 사용할 수 있습니다.

인스턴스 템플릿 만들기에 대한 자세한 내용은 인스턴스 템플릿 만들기를 참조하세요.

인스턴스의 호스트 유지보수 정책 보기

인스턴스의 세부정보를 확인하여 인스턴스의 호스트 유지보수 정책을 확인할 수 있습니다.

gcloud CLI 또는 REST API를 사용하여 인스턴스의 세부정보를 볼 때 localSsdRecoveryTimeout 및 hostErrorTimeoutSeconds 필드는 인스턴스를 만들거나 업데이트하는 동안 지정한 경우에만 볼 수 있습니다.

로컬 SSD 디스크가 연결된 인스턴스에서 로컬 SSD 데이터 복구 제한 시간을 보려면 gcloud CLI 또는 REST API를 사용하세요. 그렇지 않으면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스로 이동

  2. 이름 열에서 확인할 인스턴스를 클릭합니다. 인스턴스의 세부정보를 제공하는 페이지가 표시됩니다.

  3. 세부정보 탭의 관리 섹션에 있는 가용성 정책 섹션에서 다음을 확인할 수 있습니다.

    • 호스트 유지보수 시 필드에서 인스턴스의 호스트 유지보수 동작 이벤트를 확인할 수 있습니다.

    • 호스트 오류 제한 시간 필드에는 인스턴스가 응답하지 않는 것을 감지한 후 인스턴스를 다시 시작하거나 중지하기 전에 인스턴스가 대기하는 시간이 표시됩니다. 값이 설정되지 않은 경우(—) 기본 대기 시간은 5분 30초입니다.

    • 자동으로 다시 시작의 다시 시작 필드에서 인스턴스가 비정상 종료되거나 프로그래밍된 이유로 Compute Engine에서 인스턴스를 중지한 후에 인스턴스가 자동으로 다시 시작되는지 확인할 수 있습니다.

gcloud

인스턴스의 호스트 유지보수 정책을 보려면 --flatten 플래그를 scheduling으로 설정하고 gcloud compute instances describe 명령어를 사용합니다.

 gcloud compute instances describe INSTANCE_NAME \
    --flatten=scheduling \
    --zone=ZONE

다음을 바꿉니다.

  • INSTANCE_NAME: 인스턴스 이름입니다.

  • ZONE: 인스턴스가 있는 영역입니다.

출력은 다음과 비슷합니다.

---
scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

REST

인스턴스의 호스트 유지보수 정책을 보려면 GET 요청을 instances.get 메서드에 보냅니다. 요청 URL에 fields 쿼리 매개변수를 포함하고 scheduling으로 설정합니다.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?fields=scheduling

다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 있는 프로젝트입니다.

  • ZONE: 인스턴스가 있는 영역

  • INSTANCE_NAME: 인스턴스 이름입니다.

출력은 다음과 비슷합니다.

{
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  }
}

다음 단계