미래용 예약 요청 수정

이 문서에서는 미래용 예약 요청을 수정하는 방법을 설명합니다.

취소되지 않았거나 승인 대기 중인 상태가 아니라면 시작 시간 전에 언제든지 미래용 예약 요청을 수정할 수 있습니다. 미래용 예약 요청을 수정하는 것은 예약된 가상 머신(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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

필요한 역할

미래용 예약 요청을 수정하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 미래용 예약 관리자(roles/compute.futureReservationAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 미래용 예약 요청을 수정하는 데 필요한 compute.futureReservations.update 권한이 포함되어 있습니다.

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

수정 가능한 속성

미래용 예약 요청에는 예약을 정의하고, 동작을 결정하며, 예약할 리소스를 지정하는 여러 속성이 있습니다. 다음 섹션에 설명된 대로 이러한 속성을 수정할 수 있습니다.

생성 후

미래용 예약 요청을 만든 후에는 다음 속성을 수정할 수 없습니다.

미래용 예약 요청 이름
미래용 예약 요청이 생성된 프로젝트
미래용 예약 요청이 있는 영역
사용할 인스턴스 템플릿과 인스턴스 템플릿에 지정된 VM 속성

미래용 예약 요청이 잠금 시간으로 전환되기 전에 이러한 속성을 수정하려면 새 요청을 만듭니다.

제출 전

검토를 위해 미래용 예약 요청을 Google Cloud에 제출하기 전 또는 검토를 위해 미래용 예약 요청을 제출한 후 요청이 거부된 경우 다음 속성을 수정할 수 있습니다.

자동 삭제 옵션
설명
GPU 및 GPU 유형
로컬 SSD 디스크 및 디스크 인터페이스 유형
머신 계열 및 머신 유형
최소 CPU 플랫폼
이름 프리픽스
공유 설정
예약 기간의 시작 및 종료 시간
총 개수(VM 수)

미래용 예약 요청 초안 상태는 즉시 수정되며 수정할 수 있는 횟수에 제한이 없습니다. 거부된(DECLINED) 미래용 예약 요청을 수정하는 경우 검토를 위해 요청을 다시 제출하는 경우에만 요청을 수정할 수 있습니다.

승인 후

Google Cloud에서 미래용 예약을 승인한 후 미래용 예약이 프로비저닝(PROVISIONING) 조달 상태가 되기 전에 수정할 수 있습니다. 특히 다음 속성을 수정할 수 있습니다.

언제든지 미래용 예약 수정:
- 자동 삭제 옵션
- 설명
- 이름 프리픽스
시작 시간으로부터 72시간 이전에 수정 요청 제출:
- GPU 및 GPU 유형^*
- 로컬 SSD 디스크 및 디스크 인터페이스 유형^*
- 머신 시리즈 및 머신 유형^*
- 최소 CPU 플랫폼^*
- 공유 설정
- 예약 기간의 시작 및 종료 시간
- 총 개수(VM 수)^*

^* 미래용 예약 시작 시간부터 14일 이내에 VM 속성을 변경하거나 총 수를 크게 늘리거나 줄이도록 요청하는 경우 Google Cloud에서 요청을 거부할 가능성이 높습니다.

미래용 예약 요청 수정

미래용 예약 요청을 수정하기 전에 아직 수정하지 않은 경우 수정할 수 있는 속성을 검토하세요.

인스턴스 템플릿을 통해 만든 단일 프로젝트 미래용 예약 요청을 공유된 미래용 예약 요청으로 수정하려는 경우 동일한 템플릿으로 공유한 미래용 예약 요청을 만든 프로젝트 외부에서 자동 생성된 예약을 사용할 수 있는 VM을 만들 수 없습니다. 미래용 예약이 공유된 프로젝트의 경우 해당 프로젝트에서 유사한 인스턴스 템플릿을 만들거나 속성을 직접 지정하여 VM을 만들어야 합니다.

미래용 예약 요청을 수정하려면 다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 예약 페이지로 이동합니다.

예약으로 이동
미래용 예약 탭을 클릭합니다.
이름 열에서 수정하려는 미래용 예약 요청의 이름을 클릭합니다.

선택한 미래용 예약 요청의 세부정보 페이지가 열립니다.
승인된 미래용 예약의 자동 삭제 옵션, 설명 또는 이름 프리픽스를 수정하려면 다음 중 하나 이상을 수행합니다.
- 자동 삭제 옵션을 수정하려면 자동 생성된 예약 자동 삭제 시간 행에서 수정을 클릭하고 다음을 수행합니다.
  1. 다음 중 하나를 수행하여 자동 삭제 옵션을 사용 설정, 사용 중지 또는 수정할지 지정합니다.
    - 자동 삭제 옵션을 사용 설정하거나 Compute Engine에서 자동 생성된 예약을 자동으로 삭제하는 시간을 변경하려면 다음을 수행합니다.
      1. 자동 삭제 사용 설정 전환 버튼을 클릭하여 설정 위치로 전환합니다.
      2. (선택사항) 자동 삭제 시간에 자동 생성된 예약을 삭제할 새 날짜와 시간을 입력합니다. 날짜와 시간은 예약 기간의 종료 시간보다 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
    - 그렇지 않으면 자동 삭제 사용 설정 전환 버튼을 클릭하여 해제 위치로 전환합니다.
  2. 제출을 클릭합니다.
- 이름 프리픽스를 수정하려면 프리픽스 행에서 수정을 클릭하고 다음을 수행합니다.
  1. 프리픽스에 이름 프리픽스를 입력합니다.
  2. 제출을 클릭합니다.
- 설명을 수정하려면 설명 행에서 수정을 클릭하고 다음을 수행합니다.
  1. 설명에 새 설명을 입력합니다.
  2. 제출을 클릭합니다.
수정 또는 초안 수정을 클릭합니다.

선택한 미래용 예약 요청을 수정하는 페이지가 열립니다.
미래용 예약 요청을 수정하여 검토를 위해 Google Cloud에 제출하거나 초안 요청을 저장하려면 다음 중 하나 이상을 실행합니다.
- 프리픽스에 이 미래용 예약 요청에 대해 프로비저닝된 자동 생성 예약의 새 이름 프리픽스를 입력합니다.
- 설명에 새 설명을 입력합니다.
- 미래용 예약 요청의 시작 시간 또는 종료 시간을 수정합니다. 다음 사항이 마련되어 있는지 확인하세요.
  - 시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다.
  - 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 시작 시간에 권장되는 값을 지정합니다.
  - 검토를 위해 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 권장 최소 예약 기간을 지정합니다.
- 공유 유형 섹션에서 로컬 또는 공유를 선택할 수 있습니다. 공유를 선택하면 미래용 예약 요청을 공유할 프로젝트를 추가하거나 삭제할 수 있습니다. 프로젝트를 최대 100개까지 포함할 수 있습니다.
- VM 인스턴스 수에 예약할 총 VM 수를 입력합니다.
  
  주의: 예약할 VM 수를 늘리려면 예약을 요청할 추가 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.
- 인스턴스 템플릿을 통해 생성되지 않은 미래용 예약을 수정하는 경우 머신 구성 섹션에서 다음을 변경할 수 있습니다.
  - 예약된 VM에 사용되는 머신 계열 및 머신 유형
  - 예약된 VM에 연결할 GPU
  - 예약된 VM의 로컬 SSD 디스크 및 디스크 인터페이스 유형
- 자동 생성된 예약 자동 삭제 섹션에서 미래용 예약 요청을 위해 자동 생성된 예약의 자동 삭제를 사용 설정하거나 중지할 수 있습니다.
수정하는 미래용 예약 요청의 조달 상태에 따라 다음 중 하나를 수행합니다.
- 미래용 예약 요청 초안을 수정하는 경우 다음 중 하나를 수행합니다.
  - 변경사항을 저장하려면 초안 저장을 클릭합니다.
  - 검토를 위해 Google Cloud에 초안 미래용 예약 요청을 제출하려면 제출을 클릭합니다.
- 그렇지 않으면 제출을 클릭합니다.

수정 요청을 제출하면 예약 페이지가 열립니다. 그렇지 않으면 미래용 예약의 세부정보 페이지가 열립니다.

gcloud

미래용 예약 요청을 수정하려면 gcloud beta compute future-reservations update 명령어를 사용합니다.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

다음을 바꿉니다.

FUTURE_RESERVATION_NAME: 미래용 예약 요청의 이름
PLANNING_STATUS: 미래용 예약 요청의 계획 상태입니다. 다음 값 중 하나를 지정합니다.
- 검토를 위해 제출하지 않고 미래용 예약 요청 초안을 수정하려면 DRAFT를 지정합니다.
- 검토를 위해 미래용 예약 요청을 제출하려면 SUBMITTED를 지정합니다.
ZONE: 미래용 예약 요청이 있는 영역입니다.

다음 자리표시자 중 하나 이상을 바꾸거나 해당 플래그와 함께 삭제합니다.

예약 기간의 종료 시간이 지난 후 Compute Engine이 자동 생성된 예약을 자동으로 삭제하도록 하려면 다음 중 하나를 수행합니다.
- 종료 시간(기본값) 후 2시간 내에 예약을 삭제하려면 --auto-delete-auto-created-reservations 플래그를 포함합니다.
```
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
- 예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-delete-time 플래그를 포함합니다.
```
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
  AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.
- 예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-duration 플래그를 포함합니다.
```
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
  DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.
Compute Engine이 이러한 미래용 예약 요청에 대해 프로비저닝된 자동 생성된 예약을 자동으로 삭제하지 않도록 하려면 --no-auto-delete-auto-created-reservations 플래그를 포함합니다.
```
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
예약된 N1 VM에 연결된 GPU를 추가하거나 삭제하거나 GPU 유형을 업데이트하려면 다음 중 하나를 실행합니다.
- GPU의 수와 유형을 변경하려면 다음을 바꿉니다.
  - NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수
  - ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형입니다. 미래용 예약 요청이 있는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 요청 수정이 실패합니다.
- 예약된 N1 VM에 연결된 모든 GPU를 삭제하려면 --accelerator 플래그를 --clear-accelerator 플래그로 바꿉니다.
DESCRIPTION: 미래용 예약 요청에 대한 새로운 설명입니다.
예약된 VM에서 로컬 SSD 디스크를 추가 또는 삭제하거나 로컬 SSD 디스크 인터페이스 유형을 수정하려면 다음 중 하나를 수행합니다.
- 로컬 SSD 디스크를 추가하거나 디스크 인터페이스 유형을 수정하려면 INTERFACE를 다음 값 중 하나로 바꿉니다.
  - 부팅 디스크 이미지에 최적화된 NVMe 드라이버가 포함된 경우: nvme
  - 그 외의 경우: scsi
  추가하려는 로컬 SSD 디스크의 --local-ssd 플래그를 포함합니다. 로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다.
- 예약된 VM에 연결된 모든 로컬 SSD 디스크를 삭제하려면 모든 --local-ssd 플래그를 삭제하고 --clear-local-ssd 플래그를 포함합니다.
MACHINE_TYPE: 예약된 각 VM에 사용할 새 머신 유형 머신 유형을 변경하는 경우 새 머신 시리즈의 권장 최소 예약 기간도 지정해야 합니다. 그렇지 않으면 Google Cloud에서 수정 요청을 거부할 가능성이 높습니다.
MINIMUM_CPU_PLATFORM: 예약된 각 VM에 사용할 새로운 최소 CPU 플랫폼
NAME_PREFIX: 미래용 예약 요청에 대해 프로비저닝된 자동 생성 예약의 새 이름 프리픽스
SHARE_SETTING: 미래용 예약 요청을 위한 새로운 공유 유형입니다. 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약 요청의 경우 local을 지정합니다. 오류를 방지하려면 --share-with 플래그를 --clear-share-settings 플래그로 바꿔야 합니다.
- 공유 미래용 예약 요청의 경우 projects를 지정합니다. 오류를 방지하려면 --share-with 플래그에 소비자 프로젝트를 하나 이상 지정해야 합니다.
CONSUMER_PROJECT_IDS: 미래용 예약 요청을 공유할 프로젝트의 ID를 쉼표로 구분한 목록입니다(예: project-1,project-2). 소비자 프로젝트는 최대 100개까지 지정할 수 있습니다.
START_TIME: RFC 3339 타임스탬프 형식의 예약 기간의 새 시작 시간입니다. 시작 시간은 검토를 위해 수정 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 승인 후 또는 잠금 시간에 들어가기 전에 미래용 예약을 취소, 삭제 또는 수정할 수 있는 충분한 시간을 확보하려면 권장 시작 시간을 지정합니다.
END_TIME: RFC 3339 타임스탬프 형식의 예약 기간의 새 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 --end-time 플래그를 --duration=END_DURATION 플래그로 바꿀 수 있습니다. END_DURATION을 예약 기간(초)으로 바꿉니다. 검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 권장 예약 기간을 지정합니다.

중요: 예약 기간이 VM 속성 및 영역이 일치하고 현재 프로젝트에 생성되었거나 현재 프로젝트와 공유된 다른 기존 미래용 예약 요청의 예약 기간과 겹치지 않도록 해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
TOTAL_COUNT: 이 미래용 예약 요청에 지정된 기간, VM 구성, 프로젝트에 예약하려는 총 VM 수입니다. 총 개수를 늘리려면 예약하는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.

예를 들어 us-central1-a 영역에 있는 fr-03이라는 초안 공유 미래용 예약 요청을 살펴보겠습니다. 다음과 같이 변경하여 이 공유 미래용 예약 요청을 수정한다고 가정해 보겠습니다.

요청을 단일 프로젝트 미래용 예약 요청으로 변환합니다.
자동 삭제 옵션을 중지합니다.
VM 100개를 예약합니다.
검토를 위해 미래용 예약 요청을 Google Cloud에 제출합니다.

fr-03을 수정하려면 다음 명령어를 실행합니다.

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

미래용 예약 요청을 수정하려면 beta.futureReservations.update 메서드에 PATCH 요청을 실행합니다.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

다음을 바꿉니다.

PROJECT_ID: 미래용 예약 요청이 있는 프로젝트의 ID
ZONE: 미래용 예약 요청이 있는 영역입니다.
FUTURE_RESERVATION_NAME: 미래용 예약 요청의 이름
UPDATE_FIELDS: 요청 본문에서 업데이트할 필드의 쉼표로 구분된 목록입니다. 각 쉼표를 %2C로 인코딩해야 합니다. updateMask 쿼리 파라미터와 요청 본문에서 필드를 지정하면 필드 값이 업데이트됩니다. 그렇지 않고 updateMask 쿼리 파라미터에만 필드를 지정하면 필드가 삭제됩니다.

예를 들어 미래용 예약 요청에서 autoDeleteAutoCreatedReservations, totalCount, endTime 필드를 업데이트하려면 다음을 지정합니다.
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
PLANNING_STATUS: 미래용 예약 요청의 계획 상태입니다. 다음 값 중 하나를 지정합니다.
- 검토를 위해 제출하지 않고 미래용 예약 요청 초안을 수정하려면 DRAFT를 지정합니다.
- 검토를 위해 수정 요청을 제출하려면 SUBMITTED를 지정합니다.

다음 자리표시자 중 하나 이상을 바꾸거나 해당 필드와 함께 삭제합니다.

AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 이 필드를 true로 설정하면 Compute Engine이 미래용 예약 요청에 대해 프로비저닝된 자동 생성 예약을 자동으로 삭제합니다. 기본적으로 삭제는 예약 기간의 종료 시간 후 2시간 이내에 이루어집니다. 이를 변경하려면 다음 중 하나를 수행합니다.
- 예약 기간이 종료된 후 특정 시간에 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDeleteTime 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS"
}
```
  DELETE_TIME을 Compute Engine에서 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 RFC 3339 타임스탬프 형식이어야 합니다.
- 예약 기간의 시작 시간에서 특정 기간이 지난 후 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDuration 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS"
}
```
  DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.
DESCRIPTION: 미래용 예약 요청에 대한 새로운 설명입니다.
NAME_PREFIX: 미래용 예약 요청에 대해 프로비저닝된 자동 생성 예약의 새 이름 프리픽스
CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 미래용 예약 요청을 공유하려는 프로젝트의 ID입니다. 프로젝트는 소유자 프로젝트와 동일한 조직에 있어야 합니다. 소비자 프로젝트는 최대 100개까지 지정할 수 있습니다.
SHARE_TYPE: 미래용 예약 요청을 위한 새로운 공유 유형입니다. 다음 중 하나를 수행합니다.
- 단일 프로젝트 미래용 예약 요청을 지정하려면 다음을 수행하세요.
  - LOCAL을 지정합니다.
  - shareSettings.projects 필드를 삭제합니다.
- 공유 미래용 예약 요청을 지정하려면 다음을 수행하세요.
  - SPECIFIC_PROJECTS을 지정합니다.
  - shareSettings.projects 필드에 소비자 프로젝트를 하나 이상 지정합니다. 소비자 프로젝트는 소유자 프로젝트와 동일한 조직에 있어야 합니다. 소비자 프로젝트는 최대 100개까지 지정할 수 있습니다.
예약된 N1 VM에 연결할 GPU의 수와 유형을 변경하려면 다음을 바꿉니다.
- NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수
- ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형입니다. 미래용 예약 요청이 있는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 요청 수정이 실패합니다.
INTERFACE_1 및 INTERFACE_2: 각 예약된 VM에 연결된 로컬 SSD 디스크의 디스크 인터페이스 유형입니다. 다음 값 중 하나를 지정합니다.
- 부팅 디스크 이미지에 최적화된 NVMe 드라이버가 포함된 경우: NVME
- 그 외의 경우: SCSI
  
  로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다.
MACHINE_TYPE: 예약된 각 VM에 사용할 새 머신 유형 머신 유형을 변경하는 경우 새 머신 시리즈의 권장 최소 예약 기간도 지정해야 합니다. 그렇지 않으면 Google Cloud가 수정 요청을 승인할 가능성이 낮습니다.
MINIMUM_CPU_PLATFORM: 예약된 각 VM에 사용할 새로운 최소 CPU 플랫폼
TOTAL_COUNT: 이 미래용 예약 요청에 지정된 기간, VM 구성, 프로젝트에 예약하려는 총 VM 수입니다. 총 개수를 늘리려면 예약하는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.
START_TIME: RFC 3339 타임스탬프 형식의 예약 기간의 새 시작 시간입니다. 시작 시간은 검토를 위해 수정 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 승인 후 또는 잠금 시간에 들어가기 전에 미래용 예약을 취소, 삭제 또는 수정할 수 있는 충분한 시간을 확보하려면 권장 시작 시간을 지정합니다.
END_TIME: RFC 3339 타임스탬프 형식의 예약 기간의 새 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 endTime 필드를 duration 필드로 바꿔서 예약 기간의 시작 시간으로부터 특정 기간을 지정할 수 있습니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS",
  "timeWindow": {
    "duration": {
      "seconds": "END_DURATION"
    }
  }
}
```
END_DURATION을 초 단위의 기간으로 바꿉니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다. 검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 권장 예약 기간을 지정합니다.

중요: 예약 기간이 VM 속성 및 영역이 일치하고 현재 프로젝트에 생성되었거나 현재 프로젝트와 공유된 다른 기존 미래용 예약 요청의 예약 기간과 겹치지 않도록 해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.

요청을 단일 프로젝트 미래용 예약 요청으로 변환합니다.
자동 삭제 옵션을 중지합니다.
VM 100개를 예약합니다.
검토를 위해 미래용 예약 요청을 Google Cloud에 제출합니다.

fr-03을 수정하려면 다음과 같이 PATCH 요청을 수행합니다.

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": false,
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

미래용 예약 요청을 수정한 후 미래용 예약 요청의 세부정보를 확인하여 조달 또는 업데이트 상태를 모니터링할 수 있습니다.

미래용 예약 요청의 다른 속성 변경

미래용 예약 요청을 만든 후 요청이 승인되고 잠금 시간으로 전환되기 전에 수정할 수 없는 속성을 변경하려면 다음을 수행합니다.

미래용 예약 요청이 프로젝트 또는 미래용 예약 요청이 공유되는 프로젝트에서 만들 수 있는 미래용 예약 요청 유형을 제한하지 않도록 하려면 미래용 예약 요청을 삭제합니다.
원하는 업데이트와 함께 새 단일 프로젝트 또는 공유 미래용 예약 요청을 만듭니다.

문제 해결

미래용 예약 요청을 수정할 때 오류가 발생하면 미래용 예약 요청 문제 해결 방법을 참조하세요.

문제 해결 후에도 문제가 계속되면 계정 담당자 또는 Google Cloud 지원팀에 문의하세요.

다음 단계

미래용 예약 요청을 보는 방법 알아보기
미래용 예약 요청을 취소 또는 삭제하는 방법 알아보기
예약 기간의 시작 시간 후 자동 생성된 예약 사용 방법 알아보기
예약 기간의 종료 시간 후 자동 생성된 예약 수정 방법 알아보기

미래용 예약 요청 수정

시작하기 전에

Console

gcloud

REST

필요한 역할

수정 가능한 속성

생성 후

제출 전

승인 후

미래용 예약 요청 수정

콘솔

gcloud

REST

미래용 예약 요청의 다른 속성 변경

문제 해결

다음 단계