Compute Engine 인스턴스에서 조용히 종료 사용 설정

이 문서에서는 새 Compute Engine 인스턴스 또는 기존 Compute Engine 인스턴스에서 조용히 종료하는 기능을 사용 설정하는 방법을 설명합니다. 정상 종료에 대한 자세한 내용은 정상 종료 개요를 참고하세요.

인스턴스에서 조용히 종료를 사용 설정하면 인스턴스를 중지하거나 삭제할 때 게스트 OS가 최대 1시간 동안 완전히 종료될 수 있습니다. 이렇게 하면 잠재적인 데이터 손실이나 파일 시스템 손상을 방지할 수 있습니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. Google Cloud 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

필요한 역할

Compute 인스턴스에서 조용히 종료하는 기능을 사용 설정하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 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.update

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

단계적 종료 사용 설정

컴퓨팅 인스턴스에서 정상 종료를 사용 설정하려면 다음 방법 중 하나를 사용하세요.

기존 인스턴스에서 조용히 종료 사용 설정

기존 컴퓨팅 인스턴스를 중지하거나 다시 시작하지 않고도 조용히 종료하도록 설정할 수 있습니다. 기본 조용히 종료 기간은 10분이지만 1초에서 1시간 사이의 맞춤 종료 기간을 지정할 수 있습니다.

기존 인스턴스에서 조용히 종료하려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

    VM 인스턴스로 이동

  2. 이름 열에서 조용히 종료하도록 설정할 인스턴스의 이름을 클릭합니다.

    인스턴스의 세부정보 페이지가 열립니다.

  3. 수정을 클릭합니다.

  4. 관리 섹션에서 다음을 수행합니다.

    1. VM 단계적 종료 체크박스를 선택합니다.

    2. 선택사항: 조용히 종료 기간을 맞춤설정하려면 최대 기간 필드에 기간을 지정합니다.

  5. 저장을 클릭합니다.

gcloud

기존 인스턴스에서 조용히 종료하려면 --graceful-shutdown 플래그와 함께 gcloud beta compute instances update 명령어를 사용합니다.

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --zone=ZONE

다음을 바꿉니다.

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

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

원하는 경우 커스텀 조용히 종료 기간을 지정하려면 --graceful-shutdown-max-duration 플래그를 포함합니다.

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --zone=ZONE

MAX_DURATION을 종료 기간의 길이로 바꿉니다. 값 형식은 각각 h, m, s를 사용해서 시간, 분, 초로 지정해야 합니다. 예를 들어 1시간에는 1h을, 20분 10초에는 20m10s을 지정합니다.

REST

  1. 빈 JSON 파일을 만듭니다.

  2. 기존 인스턴스의 속성을 보려면 베타 instances.get 메서드에 GET 요청을 실행합니다.

    GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

    다음을 바꿉니다.

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

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

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

  3. 이전 단계에서 만든 빈 JSON 파일에서 다음을 수행합니다.

    1. GET 요청 출력에서 인스턴스 구성 세부정보를 입력합니다.

    2. scheduling 필드에 다음과 같이 gracefulShutdown 필드를 추가합니다.

      {
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true
    }
  },
  ...
}

      원하는 경우 커스텀 조용히 종료 기간을 지정하려면 maxDuration 필드를 포함합니다.

      {
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      ...
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  },
  ...
}

      MAX_DURATION을 조용히 종료 기간의 초 단위로 바꿉니다. 값은 3,600초 (1시간)를 나타내는 1에서 3600 사이여야 합니다.

  4. 인스턴스를 업데이트하고 다시 시작하려면 PUT 요청을 베타 instances.update 메서드에 보냅니다. 요청에서 다음을 수행합니다.

    • 요청 URL에 RESTART로 설정된 mostDisruptiveAllowedAction 쿼리 매개변수를 포함합니다.

    • 요청 본문에는 이전 단계에서 만들고 업데이트한 JSON 파일의 인스턴스 속성을 포함합니다.

    인스턴스를 업데이트하기 위한 PUT 요청은 다음과 유사합니다.

    PUT https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART

{
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true
    }
  },
  ...
}

인스턴스 속성 업데이트에 대한 자세한 내용은 인스턴스 속성 업데이트를 참고하세요.

인스턴스 생성 중에 단계적 종료 사용 설정

조용히 종료가 사용 설정된 컴퓨팅 인스턴스를 만들면 기본 종료 기간은 10분입니다. 원하는 경우 1초에서 1시간 사이의 맞춤 종료 기간을 지정할 수 있습니다.

조용히 종료가 사용 설정된 인스턴스를 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

    VM 인스턴스로 이동

  2. 인스턴스 만들기를 클릭합니다.

    인스턴스 만들기 페이지가 열립니다.

  3. 인스턴스 이름을 지정합니다.

  4. 인스턴스를 만들 리전 및 영역을 지정합니다.

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

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

  7. VM 프로비저닝 모델 고급 설정 섹션을 펼친 후 다음을 수행합니다.

    1. VM 단계적 종료 체크박스를 선택합니다.

    2. 선택사항: 조용히 종료 기간을 맞춤설정하려면 최대 기간 필드에 기간을 지정합니다.

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

gcloud

조용히 종료가 사용 설정된 인스턴스를 만들려면 --graceful-shutdown 플래그와 함께 gcloud beta compute instances create 명령어를 사용합니다.

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

다음을 바꿉니다.

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

  • MACHINE_TYPE: 인스턴스에 사용할 머신 유형입니다.

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

원하는 경우 커스텀 조용히 종료 기간을 지정하려면 --graceful-shutdown-max-duration 플래그를 포함합니다.

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

MAX_DURATION을 조용히 종료 기간의 길이로 바꿉니다. 값 형식은 각각 h, m, s를 사용해서 시간, 분, 초로 지정해야 합니다. 예를 들어 1시간에는 1h을, 20분 10초에는 20m10s을 지정합니다.

REST

조용히 종료가 사용 설정된 인스턴스를 만들려면 beta.instances.insert 메서드에 POST 요청을 보냅니다. 요청 본문에 gracefulShutdown 필드를 포함합니다.

POST https://compute.googleapis.com/compute/beta/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": {
    "gracefulShutdown": {
      "enabled": true
    }
  }
}

다음을 바꿉니다.

  • 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 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.

원하는 경우 커스텀 조용히 종료 기간을 지정하려면 요청 본문에 maxDuration 필드를 포함합니다.

POST https://compute.googleapis.com/compute/beta/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": {
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  }
}

MAX_DURATION을 조용히 종료 기간의 초 단위로 바꿉니다. 값은 3,600초 (1시간)를 나타내는 1에서 3600 사이여야 합니다.

인스턴스를 만들 때 추가 구성 옵션을 보려면 Compute Engine 인스턴스 만들기 및 시작을 참고하세요.

인스턴스를 일괄 생성하는 동안 단계적 종료 사용 설정

조용히 종료가 사용 설정된 컴퓨팅 인스턴스를 일괄적으로 만들면 기본 종료 기간은 10분입니다. 원하는 경우 1초에서 1시간 사이의 맞춤 종료 기간을 지정할 수 있습니다.

조용히 종료가 사용 설정된 인스턴스를 일괄로 만들려면 다음 옵션 중 하나를 선택합니다.

gcloud

조용히 종료가 사용 설정된 인스턴스를 일괄로 만들려면 --graceful-shutdown 플래그와 함께 gcloud beta compute instances bulk create 명령어를 사용합니다.

예를 들어 단일 영역에서 인스턴스를 일괄로 만들고 인스턴스의 이름 패턴을 지정하려면 다음 명령어를 실행합니다.

gcloud beta compute instances bulk create \
    --count=COUNT \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --zone=ZONE

다음을 바꿉니다.

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

  • MACHINE_TYPE: 인스턴스의 머신 유형입니다.

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

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

원하는 경우 커스텀 조용히 종료 기간을 지정하려면 --graceful-shutdown-max-duration 플래그를 포함합니다.

gcloud beta compute instances bulk create \
    --count=COUNT \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --zone=ZONE

MAX_DURATION을 조용히 종료 기간의 길이로 바꿉니다. 값 형식은 각각 h, m, s를 사용해서 시간, 분, 초로 지정해야 합니다. 예를 들어 1시간에는 1h을, 20분 10초에는 20m10s을 지정합니다.

REST

조용히 종료가 사용 설정된 인스턴스를 일괄로 만들려면 POST 요청을 베타 instances.bulkInsert 메서드에 보냅니다. 요청 본문에 gracefulShutdown 필드를 포함합니다.

예를 들어 단일 영역에서 인스턴스를 일괄로 만들고 인스턴스의 이름 패턴을 지정하려면 다음과 같이 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/beta/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": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

다음을 바꿉니다.

  • 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 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.

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

원하는 경우 커스텀 조용히 종료 기간을 지정하려면 요청 본문에 maxDuration 필드를 포함합니다.

POST https://compute.googleapis.com/compute/beta/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": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

MAX_DURATION을 조용히 종료 기간의 초 단위로 바꿉니다. 값은 3,600초 (1시간)를 나타내는 1에서 3600 사이여야 합니다.

인스턴스를 일괄로 만들 때 추가 구성 옵션을 보려면 VM 일괄 생성을 참고하세요.

인스턴스 템플릿을 만드는 동안 조용히 종료 사용 설정

조용히 종료가 사용 설정된 인스턴스 템플릿을 만들면 기본 종료 기간은 10분입니다. 원하는 경우 1초에서 1시간 사이의 맞춤 종료 기간을 지정할 수 있습니다.

인스턴스 템플릿을 사용하여 만든 모든 컴퓨팅 인스턴스에는 조용히 종료가 사용 설정되어 있습니다.

조용히 종료가 사용 설정된 인스턴스 템플릿을 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

    인스턴스 템플릿으로 이동

  2. 인스턴스 템플릿 만들기를 클릭합니다.

    인스턴스 템플릿 만들기 페이지가 열립니다.

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

  4. 다음과 같이 위치를 선택합니다.

    • 리전 인스턴스 템플릿을 만들어 리전 간 종속 항목을 줄이려면 다음 단계를 따르세요.

      1. 아직 선택하지 않았다면 지역별를 선택합니다.

      2. 리전 필드에서 인스턴스 템플릿을 만들 리전을 선택합니다.

    • 그렇지 않은 경우 리전 간에 인스턴스 템플릿을 사용하려면 전역을 선택합니다.

  5. 머신 구성 섹션에서 머신 유형을 지정합니다.

  6. VM 프로비저닝 모델 고급 설정 섹션을 펼친 후 다음을 수행합니다.

    1. VM 단계적 종료 체크박스를 선택합니다.

    2. 선택사항: 조용히 종료 기간을 맞춤설정하려면 최대 기간 필드에 기간을 지정합니다.

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

gcloud

조용히 종료가 사용 설정된 인스턴스 템플릿을 만들려면 --graceful-shutdown 플래그와 함께 gcloud beta compute instance-templates create 명령어를 사용합니다.

예를 들어 조용히 종료가 사용 설정된 리전 인스턴스 템플릿을 만들려면 다음 명령어를 실행합니다.

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

다음을 바꿉니다.

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

  • REGION: 인스턴스 템플릿을 만들 리전입니다.

  • MACHINE_TYPE: 인스턴스 템플릿을 사용하여 만든 인스턴스의 머신 유형입니다.

원하는 경우 커스텀 조용히 종료 기간을 지정하려면 --graceful-shutdown-max-duration 플래그를 포함합니다.

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

MAX_DURATION을 종료 기간의 길이로 바꿉니다. 값 형식은 각각 h, m, s를 사용해서 시간, 분, 초로 지정해야 합니다. 예를 들어 1시간에는 1h을, 20분 10초에는 20m10s을 지정합니다.

REST

조용히 종료가 사용 설정된 인스턴스 템플릿을 만들려면 다음 메서드 중 하나에 POST 요청을 보냅니다.

예를 들어 조용히 종료가 사용 설정된 리전 인스턴스 템플릿을 만들려면 다음과 같이 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/beta/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": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

다음을 바꿉니다.

  • 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: 인스턴스 템플릿을 사용하여 만든 인스턴스의 머신 유형입니다.

원하는 경우 커스텀 조용히 종료 기간을 지정하려면 요청 본문에 maxDuration 필드를 포함합니다.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/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": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

MAX_DURATION을 종료 기간의 초 단위로 바꿉니다. 값은 3,600초 (1시간)를 나타내는 1에서 3600 사이여야 합니다.

인스턴스 템플릿을 만들 때 추가 구성 옵션을 보려면 인스턴스 템플릿 만들기를 참고하세요.

다음 단계