미래용 예약 요청 수정, 취소 또는 삭제

이 문서에서는 미래용 예약 요청을 관리하는 방법을 설명합니다. 구체적으로는 다음과 같습니다.

초안 또는 제출된 미래용 예약 요청을 수정하여 하나 이상의 속성을 변경합니다.
미래용 예약 요청을 취소하여 Google Cloud에서 예약을 검토하거나 승인 미래용 예약이 잠금 시간으로 전환되지 않도록 합니다.
필요한 잠금 시간으로 전환되기 전 또는 예약 기간이 종료된 후 미래용 예약을 삭제합니다.

예약 기간이 종료된 후 처리된 미래용 예약에 대해 자동 생성된 예약을 관리하려면 다음을 참조하세요.

시작하기 전에

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

이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.
콘솔

Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스할 때는 인증을 설정할 필요가 없습니다.
gcloud
1. Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다.
```
gcloud init
```
  참고: gcloud CLI를 이전에 설치했으면 gcloud components update를 실행하여 최신 버전을 사용할 수 있는지 확인합니다.
2. 기본 리전 및 영역을 설정합니다.
REST

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

필요한 역할

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

이 사전 정의된 역할에는 미래용 예약 요청을 수정, 취소 또는 삭제하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

필수 권한

미래용 예약 요청을 수정, 취소 또는 삭제하려면 다음 권한이 필요합니다.

미래용 예약 취소: 프로젝트에 대한 compute.futureReservations.cancel
미래용 예약 삭제: 프로젝트에 대한 compute.futureReservations.delete
미래용 예약 수정: 프로젝트에 대한 compute.futureReservations.update

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

제한사항

미래용 예약에 대한 일반적인 제한사항 외에도 미래용 예약 요청을 수정, 취소 또는 삭제할 때 다음 제한사항이 적용됩니다.

미래용 예약 요청이 생성된 프로젝트 내에서만 미래용 예약 요청을 수정, 취소 또는 삭제할 수 있습니다. 이렇게 하면 미래용 예약 요청을 다른 프로젝트와 공유할 수 있지만 다른 프로젝트에 대한 권한만 있는 사용자는 미래용 예약 요청을 수정할 수 없습니다.

조달 상태에서 허용하는 경우에만 미래용 예약 요청을 수정, 취소 또는 삭제할 수 있습니다. 자세한 내용은 다음 표를 참고하세요.

조달 상태	취소	삭제	수정
초안 작성 중(`DRAFTING`)
승인 대기중(`PENDING_APPROVAL`)
승인됨(`APPROVED`)
거부됨(`DECLINED`)
취소됨(`CANCELED`)
조달 중(`PROCURING`)
프로비저닝 중(`PROVISIONING`)
처리됨(`FULFILLED`)		^*
부분적으로 처리됨(`FAILED_PARTIALLY_FULFILLED`)		^*
실패(`FAILED`)		^*

^* 종료 시간 이후에만 처리되었거나 부분적으로 처리되었거나 실패한 미래용 예약을 삭제할 수 있습니다.

미래용 예약 요청 수정

취소되거나 승인 대기 중인 상태가 아니라면 조달 상태가 프로비저닝 중(PROVISIONING)에 도달하기 전에 미래용 예약 요청을 수정할 수 있습니다. 미래용 예약 요청을 수정할 때 다음 속성을 변경할 수 없습니다.

모든 미래용 예약:
- 미래용 예약의 이름
- 미래용 예약 요청이 생성된 프로젝트
- 미래용 예약이 있는 영역
인스턴스 템플릿을 지정하여 생성된 미래용 예약 요청의 경우:
- 인스턴스 템플릿에 지정된 VM 속성을 재정의할 수 없습니다.
- 미래용 예약 요청을 만드는 데 사용되는 인스턴스 템플릿을 다른 템플릿으로 바꿀 수는 없습니다.

이러한 속성을 수정하려면 원하는 업데이트로 새로운 미래용 예약 요청을 만들어야 합니다.

다른 속성을 수정하려면 다음 방법 중 하나를 선택합니다.

초안 또는 거부된 미래용 예약 요청을 수정합니다.

이 섹션에서는 조달 상태가 초안 작성 중(DRAFTING) 또는 거부됨(DECLINED)으로 설정된 미래용 예약 요청을 수정하는 방법을 설명합니다.
승인된 또는 조달 중인 미래용 예약을 수정합니다.

이 섹션에서는 조달 상태가 승인됨(APPROVED) 또는 조달 중(PROCURING)으로 설정된 미래용 예약을 수정하는 방법을 설명합니다. 미래용 예약의 자동 삭제 옵션, 설명 또는 이름 프리픽스를 수정하려면 검토 없이 수정하면 됩니다. 그렇지 않고 다른 속성을 수정하려면 Google Cloud 승인이 필요합니다.

초안 또는 거부된 미래용 예약 요청 수정

초안 예약 요청을 수정하는 경우 변경사항을 저장하거나 업데이트된 미래용 예약 요청을 Google Cloud에 제출하여 검토를 받을 수 있습니다. 대신 거부된 미래용 예약을 수정할 경우 검토를 위해 요청을 제출해야 합니다.

초안 또는 거부된 미래용 예약 요청의 속성을 수정하려면 다음 방법 중 하나를 선택합니다.

인스턴스 템플릿을 지정하여 초안 또는 거부된 미래용 예약 요청을 수정합니다.

이 섹션에서는 인스턴스 템플릿을 지정하여 생성된 초안 또는 거부된 미래용 예약 요청에서 하나 이상의 속성을 수정하는 방법을 설명합니다. 미래용 예약 요청의 VM 속성은 수정할 수 없습니다. 대신 새로운 미래용 예약을 만들어야 합니다.
속성을 직접 지정하여 생성된 초안 또는 거부된 미래용 예약 요청을 수정합니다.

이 섹션에서는 속성을 직접 지정하여 생성된 초안 또는 거부된 미래용 예약 요청에서 하나 이상의 속성을 수정하는 방법을 설명합니다.

인스턴스 템플릿을 지정하여 초안 또는 거부된 미래용 예약 수정

조달 상태가 초안 작성 중(DRAFTING) 또는 거부됨(DECLINED)이며 인스턴스 템플릿을 지정하여 만든 미래용 예약 요청의 경우 다음 속성을 수정할 수 있습니다.

자동 삭제
설명
이름 프리픽스
공유 설정
예약 기간의 시작 및 종료 시간
총 개수(VM 수)

Google Cloud 콘솔, gcloud CLI, REST를 사용하여 인스턴스 템플릿을 지정하면 초안 또는 거부된 향후 미래용 예약을 수정할 수 있습니다.

콘솔

Google Cloud에 인스턴스 템플릿을 지정하여 생성된 초안 또는 거부된 미래용 예약 요청을 수정하도록 요청하려면 다음 단계를 따르세요.

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

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

선택한 미래용 예약 요청의 세부정보 페이지가 열립니다.
미래용 예약 요청을 수정하려면 수정 또는 초안 수정을 클릭합니다.

선택한 미래용 예약 요청을 수정하는 페이지가 열립니다.
다음 중 하나 이상을 수행합니다.
- 프리픽스 필드에 새 이름 프리픽스를 입력합니다.
- 설명 필드에 새 설명을 입력합니다.
- 미래용 예약 요청의 시작 시간 또는 종료 시간을 수정합니다. 다음 사항이 마련되어 있는지 확인하세요.
  - 시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다.
  - 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 시작 시간에 권장되는 값을 지정합니다.
  - 검토를 위해 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 권장 최소 예약 기간을 지정합니다.
- 공유 유형 섹션에서 로컬 또는 공유를 선택할 수 있습니다. 공유를 선택하면 미래용 예약 요청을 공유할 프로젝트를 추가하거나 삭제할 수 있습니다.
  
  프로젝트는 최대 100개까지 선택할 수 있습니다. 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.
- VM 인스턴스 수에 해당 기간 동안 예약하려는 VM의 총 개수, VM 구성 및 미래용 예약 요청에 지정된 프로젝트를 입력합니다.
  
  승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.
  
  주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.
- 자동 생성된 예약 자동 삭제 섹션에서 미래용 예약 요청을 위해 자동 생성된 예약의 자동 삭제를 사용 설정하거나 중지할 수 있습니다.
  
  주의: 자동 삭제 옵션이 사용 설정된 경우 자동 생성된 모든 예약은 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
  
  선택사항입니다. 자동 삭제 옵션을 사용 설정하면 Compute Engine에서 자동 생성된 예약을 삭제하는 날짜와 시간을 지정할 수 있습니다. 날짜와 시간은 예약 기간의 종료 시간 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
수정하는 미래용 예약 요청의 조달 상태에 따라 다음 중 하나를 수행합니다.
- 초안 미래용 예약 요청의 경우 다음 옵션 중 하나를 선택합니다.
  - 변경사항을 저장하려면 초안 저장을 클릭합니다.
  - 검토를 위해 Google Cloud에 초안 미래용 예약 요청을 제출하려면 제출을 클릭합니다.
- 미래용 예약 요청이 거부되면 제출을 클릭해야만 검토를 위해 제출할 수 있습니다.
  
  요청을 제출하면 예약 페이지가 열립니다. 그렇지 않으면 미래용 예약 요청의 세부정보 페이지가 열립니다.

gcloud

Google Cloud에 인스턴스 템플릿을 지정하여 생성된 초안 또는 거부된 미래용 예약 요청을 수정하도록 요청하려면 gcloud beta compute future-reservations update 명령어를 사용합니다.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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: 기존 초안 또는 거부된 예약 요청의 이름입니다.

DESCRIPTION: 선택사항. 미래용 예약 요청에 대한 새로운 설명입니다.

NAME_PREFIX: 선택사항. 미래용 예약 요청을 위한 새 이름 프리픽스입니다. 미래용 예약 요청에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약 요청에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약 요청의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약 요청을 Google Cloud에 제출하여 검토를 받을 수 있습니다.

참고: 초안 미래용 예약 요청을 수정하고 검토를 위해 요청을 Google Cloud에 제출하는 대신 변경사항을 저장하려면 --planning-status 플래그를 생략합니다.

PROJECT_ID: 선택사항. 미래용 예약 요청이 생성된 프로젝트의 ID입니다. 단일 프로젝트 미래용 예약 요청을 공유된 미래용 예약 요청으로 수정하면 이 프로젝트는 미래용 예약 요청의 소유자 프로젝트가 됩니다. --project 플래그를 생략하면 값이 현재 프로젝트의 ID로 설정됩니다.

SHARE_SETTING: 선택사항. 이 미래용 예약 요청의 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약 요청을 공유된 미래용 예약 요청으로 변경하려면 projects를 지정합니다. --share-with 플래그를 사용하여 소비자 프로젝트를 최소 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
- 그렇지 않은 경우 local을 지정합니다.
  
  중요: local을 지정할 경우 --share-with 플래그를 생략해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
CONSUMER_PROJECT_IDS: 선택사항. 이 미래용 예약 요청을 공유할 수 있는 프로젝트의 프로젝트 ID를 쉼표로 구분한 목록입니다. 예를 들어 project-1,project-2를 지정합니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.
START_TIME: 선택사항. 다음과 같이 표시해야 하는 RFC 3339 타임스탬프 형식의 예약 기간의 새 시작 시간입니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
다음을 바꿉니다.
- YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
- HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
- OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 승인 후 또는 잠금 시간을 시작하기 전에 미래용 예약을 취소, 삭제 또는 수정할 수 있는 충분한 시간을 확보하려면 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 --end-time 플래그를 --duration=END_DURATION 플래그로 바꿀 수 있습니다. 여기서 END_DURATION은 예약 기간(초)입니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.

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

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.

ZONE: 미래용 예약 요청이 있는 영역입니다.

선택적으로 다음 중 하나를 수행하여 미래용 예약 요청에 대해 Compute Engine에서 자동 생성된 예약을 자동으로 삭제할지 여부 및 시기를 변경할 수도 있습니다.

Compute Engine이 예약 기간이 종료된 후 자동 생성된 예약을 자동으로 삭제할 수 있도록 하려면 다음 방법 중 하나를 선택합니다.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 종료 시간(기본값) 후 2시간 내에 예약을 삭제하려면 --auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- 예약 기간 종료 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-delete-time 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.
- 예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-duration 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.
Compute Engine이 자동 생성된 예약을 자동으로 삭제하지 않도록 하려면 --no-auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

예를 들어 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 \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Google Cloud에 인스턴스 템플릿을 지정하여 생성된 초안 또는 거부된 미래용 예약 요청을 수정하도록 요청하려면 beta.futureReservations.update 메서드에 PATCH 요청을 실행합니다. updateMask 쿼리 매개변수에서 업데이트할 각 필드를 지정합니다. 예약에서 선택적 필드를 삭제해야 하는 경우 updateMask 쿼리 매개변수에 해당 필드를 포함하고 요청 본문에서 해당 필드를 생략합니다.

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": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

다음을 바꿉니다.

PROJECT_ID: 미래용 예약 요청이 있는 프로젝트의 ID입니다.
ZONE: 미래용 예약 요청이 있는 영역입니다.
FUTURE_RESERVATION_NAME: 기존 초안 또는 거부된 예약 요청의 이름입니다. 미래용 예약 요청의 이름은 수정할 수 없습니다.
UPDATE_FIELDS: 이 PATCH 요청에서 업데이트할 쉼표로 구분된 필드 목록입니다. 각 쉼표를 %2C로 인코딩해야 합니다. 예를 들어 미래용 예약 요청에서 autoDeleteAutoCreatedReservations, totalCount, endTime 필드를 업데이트하려면 다음을 지정합니다.
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 선택사항. 이 필드를 true로 설정하면 Compute Engine이 이 미래용 예약 요청에 대해 자동 생성된 예약을 자동으로 삭제합니다. 기본적으로 삭제 시간은 예약 기간의 종료 시간에서 2시간 이내입니다. 이를 변경하려면 다음 중 하나를 수행하세요.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 예약 기간이 종료된 후 특정 시간에 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDeleteTime 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  DELETE_TIME을 Compute Engine에서 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 다음과 같은 RFC 3339 타임스탬프 형식이어야 합니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  다음을 바꿉니다.
  - YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
  - HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
  - OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
- 예약 기간의 시작 시간에서 특정 기간이 지난 후 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDuration 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.
DESCRIPTION: 선택사항. 이 미래용 예약 요청에 대한 설명을 업데이트하려면 다음 중 하나를 수행합니다.
- 설명을 추가하거나 업데이트하려면 설명을 지정합니다.
- 설명을 삭제하려면 요청 본문에서 description 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.
NAME_PREFIX: 선택사항. 미래용 예약 요청을 위한 새 이름 프리픽스입니다. 미래용 예약 요청에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약 요청의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약 요청을 Google Cloud에 제출하여 검토를 받을 수 있습니다.

참고: 초안 미래용 예약 요청을 수정하고 검토를 위해 요청을 Google Cloud에 제출하는 대신 변경사항을 저장하려면 planningStatus 필드를 생략합니다.
SHARE_TYPE: 선택사항. 이 미래용 예약 요청의 공유 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약 요청을 공유된 미래용 예약 요청으로 변경하려면 SPECIFIC_PROJECTS를 지정합니다. 또한 projects 필드에 소비자 프로젝트를 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
- 그렇지 않은 경우 LOCAL을 지정합니다. 또한 요청 본문에서 projects 필드를 삭제하고 UPDATE_FIELDS에 지정해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 선택사항. 공유 미래용 예약 요청을 공유할 수 있는 프로젝트의 프로젝트 ID입니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.

TOTAL_COUNT: 선택사항. 이 미래용 예약 요청에 지정된 기간, VM 구성, 프로젝트에 예약하려는 총 VM 수입니다.

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.
START_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새 시작 시간입니다. 시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 또한 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 endTime 필드를 duration 필드로 바꿔서 예약 기간의 시작 시간으로부터 특정 기간을 지정할 수 있습니다.
```
"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에 미래용 예약 요청을 제출한 후 세부정보를 확인하여 조달 상태를 모니터링합니다.

속성을 직접 지정하여 생성된 초안 또는 거부된 미래용 예약 수정

초안 작성 중(DRAFTING) 또는 거부됨(DECLINED)으로 설정된 조달 상태로 속성을 직접 지정하여 만든 미래용 예약 요청의 경우 다음 속성을 수정할 수 있습니다.

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

Google Cloud 콘솔, gcloud CLI, REST를 사용하여 속성을 직접 지정하면 생성된 초안 또는 거부된 미래용 예약 요청을 수정할 수 있습니다.

콘솔

Google Cloud에 속성을 직접 지정하여 생성된 초안 또는 거부된 미래용 예약 요청을 수정하도록 Google Cloud에 요청하려면 다음 단계를 따르세요.

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

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

선택한 미래용 예약 요청의 세부정보 페이지가 열립니다.
미래용 예약 요청을 수정하려면 수정 또는 초안 수정을 클릭합니다.

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

gcloud

속성을 직접 지정하여 생성된 초안 또는 거부된 미래용 예약 요청을 Google Cloud에 수정하도록 요청하려면 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_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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: 기존 초안 또는 거부된 예약 요청의 이름입니다.

선택사항입니다. 다음 중 하나를 수행합니다.
- 예약된 각 VM에 그래픽 처리 장치(GPU)를 추가하려면 다음을 지정합니다.
  - NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수입니다.
  - ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형입니다.
  미래용 예약 요청에서 지정한 머신 유형이 지정한 GPU 유형을 지원하는지, 그리고 리소스를 예약하려는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 오류가 발생합니다.
- 이 미래용 예약 요청에서 모든 GPU를 삭제하려면 --accelerator 플래그를 --clear-accelerator 플래그로 바꿉니다.

DESCRIPTION: 선택사항. 미래용 예약 요청에 대한 새로운 설명입니다.

선택사항입니다. 다음 중 하나를 수행합니다.
- 각 VM에서 로컬 SSD에 사용할 인터페이스 유형을 추가하거나 수정하려면 INTERFACE_1 및 INTERFACE_2를 바꿉니다. 값은 다음 중 하나여야 합니다.
  - 부팅 디스크 이미지에 최적화된 NVMe 드라이버가 있는 경우 nvme를 지정합니다.
  - 그렇지 않은 경우 scsi을 지정합니다.
  각 로컬 SSD는 375GB입니다. 추가하려는 각 로컬 SSD에 대해 --local-ssd 플래그를 반복합니다. 최대 24개의 로컬 SSD를 지정할 수 있습니다.
- 이 미래용 요청 예약에서 모든 로컬 SSD를 삭제하려면 모든 --local-ssd 플래그를 삭제하고 --clear-local-ssd 플래그를 지정합니다.
MACHINE_TYPE: 선택사항. 각 VM에 사용할 사전 정의된 또는 커스텀 머신 유형입니다. 커스텀 머신 유형을 지정하기 전에 커스텀 머신 유형의 VM에 대한 제한사항을 검토하세요.

참고: 이전에 지정한 머신 계열과 다른 머신 계열을 지정하는 경우 지정한 머신 계열의 권장 최소 예약 기간을 지정해야 합니다. 그렇지 않으면 Google Cloud가 요청을 승인할 가능성이 낮습니다.
MINIMUM_CPU_PLATFORM: 선택사항. 각 VM에 사용할 최소 CPU 플랫폼입니다. --min-cpu-platform 플래그를 생략하면 값이 영역의 기본 CPU 플랫폼으로 설정됩니다.

NAME_PREFIX: 선택사항. 미래용 예약 요청을 위한 새 이름 프리픽스입니다. 미래용 예약 요청에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약 요청에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약 요청의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약 요청을 Google Cloud에 제출하여 검토를 받을 수 있습니다.

참고: 초안 미래용 예약 요청을 수정하고 검토를 위해 요청을 Google Cloud에 제출하는 대신 변경사항을 저장하려면 --planning-status 플래그를 생략합니다.

PROJECT_ID: 선택사항. 미래용 예약 요청이 생성된 프로젝트의 ID입니다. 단일 프로젝트 미래용 예약 요청을 공유된 미래용 예약 요청으로 수정하면 이 프로젝트는 미래용 예약 요청의 소유자 프로젝트가 됩니다. --project 플래그를 생략하면 값이 현재 프로젝트의 ID로 설정됩니다.

SHARE_SETTING: 선택사항. 이 미래용 예약 요청의 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약 요청을 공유된 미래용 예약 요청으로 변경하려면 projects를 지정합니다. --share-with 플래그를 사용하여 소비자 프로젝트를 최소 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
- 그렇지 않은 경우 local을 지정합니다.
  
  중요: local을 지정할 경우 --share-with 플래그를 생략해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
CONSUMER_PROJECT_IDS: 선택사항. 이 미래용 예약 요청을 공유할 수 있는 프로젝트의 프로젝트 ID를 쉼표로 구분한 목록입니다. 예를 들어 project-1,project-2를 지정합니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.
START_TIME: 선택사항. 다음과 같이 표시해야 하는 RFC 3339 타임스탬프 형식의 예약 기간의 새 시작 시간입니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
다음을 바꿉니다.
- YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
- HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
- OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 승인 후 또는 잠금 시간을 시작하기 전에 미래용 예약을 취소, 삭제 또는 수정할 수 있는 충분한 시간을 확보하려면 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 --end-time 플래그를 --duration=END_DURATION 플래그로 바꿀 수 있습니다. 여기서 END_DURATION은 예약 기간(초)입니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.

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

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.

ZONE: 미래용 예약 요청이 있는 영역입니다.

Compute Engine이 예약 기간이 종료된 후 자동 생성된 예약을 자동으로 삭제할 수 있도록 하려면 다음 방법 중 하나를 선택합니다.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 종료 시간(기본값) 후 2시간 내에 예약을 삭제하려면 --auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- 예약 기간 종료 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-delete-time 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.
- 예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-duration 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.
Compute Engine이 자동 생성된 예약을 자동으로 삭제하지 않도록 하려면 --no-auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

이를 단일 프로젝트 미래용 예약 요청으로 변환합니다.
자동 삭제 옵션을 사용 중지합니다.
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 \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Google Cloud에 속성을 직접 지정하여 생성된 초안 또는 거부된 미래용 예약 요청을 수정하도록 요청하려면 beta.futureReservations.update 메서드에 PATCH 요청을 실행합니다. updateMask 쿼리 매개변수에서 업데이트할 각 필드를 지정합니다. 예약에서 선택적 필드를 삭제해야 하는 경우 updateMask 쿼리 매개변수에 해당 필드를 포함하고 요청 본문에서 해당 필드를 생략합니다.

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: 이 PATCH 요청에서 업데이트할 쉼표로 구분된 필드 목록입니다. 각 쉼표를 %2C로 인코딩해야 합니다. 예를 들어 미래용 예약 요청에서 autoDeleteAutoCreatedReservations, totalCount, endTime 필드를 업데이트하려면 다음을 지정합니다.
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 선택사항. 이 필드를 true로 설정하면 Compute Engine이 이 미래용 예약 요청에 대해 자동 생성된 예약을 자동으로 삭제합니다. 기본적으로 삭제 시간은 예약 기간의 종료 시간에서 2시간 이내입니다. 이를 변경하려면 다음 중 하나를 수행하세요.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 예약 기간이 종료된 후 특정 시간에 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDeleteTime 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  DELETE_TIME을 Compute Engine에서 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 다음과 같은 RFC 3339 타임스탬프 형식이어야 합니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  다음을 바꿉니다.
  - YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
  - HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
  - OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
- 예약 기간의 시작 시간에서 특정 기간이 지난 후 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDuration 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.
DESCRIPTION: 선택사항. 이 미래용 예약 요청에 대한 설명을 업데이트하려면 다음 중 하나를 수행합니다.
- 설명을 추가하거나 업데이트하려면 설명을 지정합니다.
- 설명을 삭제하려면 요청 본문에서 description 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.
NAME_PREFIX: 선택사항. 미래용 예약 요청을 위한 새 이름 프리픽스입니다. 미래용 예약 요청에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약 요청의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약 요청을 Google Cloud에 제출하여 검토를 받을 수 있습니다.

참고: 초안 미래용 예약 요청을 수정하고 검토를 위해 요청을 Google Cloud에 제출하는 대신 변경사항을 저장하려면 planningStatus 필드를 생략합니다.
SHARE_TYPE: 선택사항. 이 미래용 예약 요청의 공유 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약 요청을 공유된 미래용 예약 요청으로 변경하려면 SPECIFIC_PROJECTS를 지정합니다. 또한 projects 필드에 소비자 프로젝트를 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
- 그렇지 않은 경우 LOCAL을 지정합니다. 또한 요청 본문에서 projects 필드를 삭제하고 UPDATE_FIELDS에 지정해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 선택사항. 공유 미래용 예약 요청을 공유할 수 있는 프로젝트의 프로젝트 ID입니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.

선택사항입니다. 예약된 각 VM에 연결된 그래픽 처리 장치(GPU)를 업데이트하려면 다음 중 하나를 수행합니다.
- GPU를 추가하거나 수정하려면 다음을 지정합니다.
  - NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수입니다.
  - ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형입니다.
  미래용 예약 요청에서 지정한 머신 유형이 지정한 GPU 유형을 지원하는지, 그리고 리소스를 예약하려는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 오류가 발생합니다.
- 이 미래용 예약 요청에서 모든 GPU를 삭제하려면 요청 본문에서 guestAccelerators 필드를 생략하고 UPDATE_FIELDS에 지정합니다.
선택사항입니다. 예약된 각 VM에 연결된 로컬 SSD를 업데이트하려면 다음 중 하나를 수행합니다.
- 각 VM에서 로컬 SSD에 사용할 인터페이스 유형을 추가하거나 수정하려면 INTERFACE_1 및 INTERFACE_2를 바꿉니다. 값은 다음 중 하나여야 합니다.
  - 부팅 디스크 이미지에 최적화된 NVMe 드라이버가 있는 경우 NVME를 지정합니다.
  - 그렇지 않은 경우 SCSI을 지정합니다.
  추가 또는 업데이트할 각 로컬 SSD에 대해 diskSizeGb 및 interface 필드를 반복합니다. 최대 24개의 로컬 SSD를 지정할 수 있습니다.
- 이 미래용 요청 예약에서 모든 로컬 SSD를 삭제하려면 요청 본문에서 localSsds 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.
MACHINE_TYPE: 선택사항. 각 VM에 사용할 사전 정의된 또는 커스텀 머신 유형입니다. 커스텀 머신 유형을 지정하기 전에 커스텀 머신 유형의 VM에 대한 제한사항을 검토하세요.

참고: 이전에 지정한 머신 계열과 다른 머신 계열을 지정하는 경우 지정한 머신 계열의 권장 최소 예약 기간을 지정해야 합니다. 그렇지 않으면 Google Cloud가 요청을 승인할 가능성이 낮습니다.
MINIMUM_CPU_PLATFORM: 선택사항. 각 VM에 사용할 최소 CPU 플랫폼을 업데이트하려면 다음 중 하나를 수행합니다.
- 최소 CPU 플랫폼을 추가하거나 업데이트하려면 최소 CPU 플랫폼을 지정합니다.
- 영역의 기본 CPU 플랫폼으로 되돌리려면 요청 본문에서 minCpuPlatform 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.

TOTAL_COUNT: 선택사항. 이 미래용 예약 요청에 지정된 기간, VM 구성, 프로젝트에 예약하려는 총 VM 수입니다.

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.
START_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새 시작 시간입니다. 시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 또한 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 endTime 필드를 duration 필드로 바꿔서 예약 기간의 시작 시간으로부터 특정 기간을 지정할 수 있습니다.
```
"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에 미래용 예약 요청을 제출한 후 세부정보를 확인하여 조달 상태를 모니터링합니다.

승인 또는 조달 중인 미래용 예약 수정

승인 또는 조달 중인 미래용 예약의 속성을 수정하려면 다음 방법 중 하나를 선택합니다.

검토 없이 승인 또는 조달 중인 미래용 예약을 수정합니다.

이 섹션에서는 검토 없이 승인 또는 조달 중인 미래용 예약의 자동 삭제 옵션, 설명, 이름 프리픽스를 수정하는 방법을 설명합니다. 이러한 속성은 즉시 수정되며 Google Cloud에서 예약을 만들기 시작할 때까지는 변경할 수 있는 횟수에 제한이 없습니다.
승인 또는 조달 중인 미래용 예약 수정 요청

이 섹션에서는 승인 또는 조달 중인 미래용 예약에서 하나 이상의 속성을 수정하도록 Google Cloud에 요청하는 방법을 설명합니다. 조달 상태가 조달 중(PROCURING)인 미래용 예약 수정 요청만 제출할 수 있습니다.

검토 없이 승인 또는 미래용 예약 조달 수정

조달 상태가 승인됨(APPROVED) 또는 조달 중(PROCURING)으로 설정된 미래용 예약의 경우 Google Cloud의 승인 없이 다음 필드를 수정할 수 있습니다.

자동 삭제
설명
이름 프리픽스

이러한 속성은 즉시 수정됩니다. 미래용 예약의 예약 기간 시작 시간까지 이러한 속성을 수정할 수 있는 횟수에는 제한이 없습니다.

Google Cloud 콘솔, gcloud CLI, REST를 사용하여 검토 없이 승인 또는 조달 중인 미래용 예약을 수정할 수 있습니다.

콘솔

검토 없이 승인 또는 조달 중인 미래용 예약을 수정하려면 다음 단계를 따르세요.

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

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

선택한 미래용 예약의 세부정보 페이지가 열립니다.
미래용 예약의 자동 삭제 옵션 및 설명을 수정하려면 다음 중 하나 이상을 수행합니다.
- 자동 생성된 예약 자동 삭제 시간 행에서 수정을 클릭한 후 다음 단계를 따릅니다.
  1. 다음 중 하나를 수행합니다.
    - Compute Engine이 미래용 예약 요청을 위해 자동 생성된 예약을 자동으로 삭제하도록 하려면 다음 안내를 따르세요.
      
      주의: 자동 삭제 옵션이 사용 설정된 경우 자동 생성된 모든 예약은 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
      1. 자동 삭제 사용 설정 전환 버튼을 클릭하여 사용 위치로 전환합니다.
      2. 선택사항: 자동 삭제 시간 필드에 자동 생성된 예약을 삭제할 새로운 날짜와 시간을 입력합니다. 날짜와 시간은 예약 기간의 종료 시간 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
    - 그렇지 않으면 자동 삭제 사용 설정 전환 버튼을 클릭하여 해제 위치로 전환합니다.
  2. 제출을 클릭합니다.
- 프리픽스 행에서 수정을 클릭한 후 다음을 수행합니다.
  1. 프리픽스 필드에 새 이름 프리픽스를 입력합니다.
  2. 제출을 클릭합니다.
- 설명 행에서 수정을 클릭한 후 다음을 수행합니다.
  1. 설명 필드에 새 설명을 입력합니다.
  2. 제출을 클릭합니다.

gcloud

검토 없이 승인 또는 조달 중인 미래용 예약을 수정하려면 gcloud beta compute future-reservations update 명령어를 사용합니다.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --project=PROJECT_ID \
    --zone=ZONE

다음을 바꿉니다.

FUTURE_RESERVATION_NAME: 기존 승인 또는 미래용 조달 예약의 이름입니다.

DESCRIPTION: 선택사항. 미래용 예약에 대한 새로운 설명입니다.

NAME_PREFIX: 선택사항. 미래용 예약을 위한 새 이름 프리픽스입니다. 이 미래용 예약에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PROJECT_ID: 선택사항. 미래용 예약이 생성된 프로젝트의 ID입니다.

ZONE: 미래용 예약이 있는 영역입니다.

선택적으로 다음 중 하나를 수행하여 미래용 예약에 대해 Compute Engine에서 자동 생성된 예약을 자동으로 삭제할지 여부 및 시기를 변경할 수도 있습니다.

Compute Engine이 예약 기간이 종료된 후 자동 생성된 예약을 자동으로 삭제할 수 있도록 하려면 다음 방법 중 하나를 선택합니다.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 종료 시간(기본값) 후 2시간 내에 예약을 삭제하려면 --auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- 예약 기간 종료 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-delete-time 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.
- 예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-duration 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.
Compute Engine이 자동 생성된 예약을 자동으로 삭제하지 않도록 하려면 --no-auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

예를 들어 이름이 fr-04이고 us-central1-a 영역에 있는 승인된 미래용 예약을 가정해 보겠습니다. 다음과 같이 변경하여 이 미래용 예약을 수정한다고 가정해 보겠습니다.

자동 삭제 옵션을 사용 설정합니다.
864,000초(10일) 후 자동 생성된 예약을 자동으로 삭제
새 이름 프리픽스를 지정합니다.

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

gcloud beta compute future-reservations update fr-04 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=864000 \
    --name-prefix=new-prefix \
    --project=example-project \
    --zone=us-central1-a

REST

검토 없이 승인 또는 조달 중인 미래용 예약을 수정하려면 beta.futureReservations.update 메서드에 PATCH 요청을 실행합니다. updateMask 쿼리 매개변수에서 업데이트할 각 필드를 지정합니다. 예약에서 선택적 필드를 삭제해야 하는 경우 updateMask 쿼리 매개변수에 해당 필드를 포함하고 요청 본문에서 해당 필드를 생략합니다.

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"
}

다음을 바꿉니다.

PROJECT_ID: 미래용 예약이 있는 프로젝트의 ID입니다.
ZONE: 미래용 예약이 있는 영역입니다.
FUTURE_RESERVATION_NAME: 기존 승인 또는 미래용 조달 예약의 이름입니다. 미래용 예약 이름은 수정할 수 없습니다.
UPDATE_FIELDS: 이 PATCH 요청에서 업데이트할 쉼표로 구분된 필드 목록입니다. 각 쉼표를 %2C로 인코딩해야 합니다. 예를 들어 미래용 예약에서 description 및 namePrefix 필드를 업데이트하려면 다음을 지정합니다.
```
description%2CnamePrefix
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 선택사항. 이 필드를 true로 설정하면 Compute Engine이 이 미래용 예약에 대해 자동 생성된 예약을 자동으로 삭제합니다. 기본적으로 삭제 시간은 예약 기간의 종료 시간에서 2시간 이내입니다. 이를 변경하려면 다음 중 하나를 수행하세요.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 예약 기간이 종료된 후 특정 시간에 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDeleteTime 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  DELETE_TIME을 Compute Engine에서 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 다음과 같은 RFC 3339 타임스탬프 형식이어야 합니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  다음을 바꿉니다.
  - YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
  - HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
  - OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
- 예약 기간의 시작 시간에서 특정 기간이 지난 후 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDuration 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.
DESCRIPTION: 선택사항. 이 미래용 예약 요청에 대한 설명을 업데이트하려면 다음 중 하나를 수행합니다.
- 설명을 추가하거나 업데이트하려면 설명을 지정합니다.
- 설명을 삭제하려면 요청 본문에서 description 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.
NAME_PREFIX: 선택사항. 미래용 예약을 위한 새 이름 프리픽스입니다. 이 미래용 예약에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

자동 삭제 옵션을 사용 설정합니다.
864,000초(10일) 후 자동 생성된 예약을 자동으로 삭제
새 이름 프리픽스를 지정합니다.

fr-04을 수정하려면 다음 PATCH 요청을 수행합니다.

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "864000"
  },
  "name": "fr-04",
  "namePrefix": "new-prefix"
}

승인 또는 조달 중인 미래용 예약 수정 요청

다음과 같이 Google Cloud에 조달 상태가 승인됨(APPROVED) 또는 조달 중(PROCURING)으로 설정된 미래용 예약을 수정하도록 요청할 수 있습니다.

승인된 미래용 예약을 수정하도록 요청하면 Google Cloud가 다음 중 하나를 수행합니다.
- 요청을 승인하고 조달 상태를 승인됨(APPROVED)으로 설정하세요. 예약 기간의 시작 시간이 56일(8주) 이내이면 Compute Engine이 몇 분 내에 조달 상태를 조달 중(PROCURING)으로 설정합니다.
- 요청을 거부하고 조달 상태를 거부됨(DECLINED)으로 설정합니다. 미래용 예약을 다시 수정하려면 이 문서의 초안 또는 거부된 미래용 예약 수정을 참조하세요.
조달 중인 미래용 예약을 수정하도록 요청하면 Compute Engine에서 미래용 예약의 업데이트 상태를 만들고 업데이트 승인 대기 중(AMENDMENT_PENDING_APPROVAL)으로 설정합니다. 그런 다음 Google Cloud에서 요청을 검토하고 다음 중 하나를 수행합니다.
- 요청을 승인하고 업데이트 상태를 업데이트 승인됨(AMENDMENT_APPROVED)으로 설정합니다.
- 요청을 거부하고 업데이트 상태를 업데이트 거부됨(AMENDMENT_DECLINED)으로 설정하며 자동 생성된 예약에 이전에 승인된 속성을 계속 사용합니다.
Google Cloud가 조달 중인 미래용 예약을 수정하기 위한 요청을 검토하는 동안에는 Google Cloud가 요청을 승인하거나 거부할 때까지 일반적으로 승인 없이 수정할 수 있는 속성을 포함하여 모든 속성을 수정할 수 없습니다.

Google Cloud에 승인 또는 조달 중인 미래용 예약의 속성을 수정하도록 요청하려면 다음 방법 중 하나를 선택합니다.

인스턴스 템플릿을 지정하여 생성된 미래용 예약 수정을 요청합니다.

이 섹션에서는 인스턴스 템플릿을 지정하여 생성된 승인 및 제출된 미래용 예약에서 하나 이상의 속성을 수정하도록 Google Cloud에 요청하는 방법을 설명합니다. 미래용 예약을 만들거나 미래용 예약의 VM 속성을 재정의하는 데 사용되는 인스턴스 템플릿을 대체할 수 없습니다.
속성을 직접 지정하여 생성된 미래용 예약 수정을 요청합니다.

이 섹션에서는 속성을 직접 지정하여 생성된 제출 및 승인된 미래용 예약에서 하나 이상의 속성을 수정하도록 Google Cloud에 요청하는 방법을 설명합니다.

인스턴스 템플릿을 지정하여 생성된 미래용 예약 수정 요청

조달 상태가 승인됨(APPROVED) 또는 조달 중(PROCURING)이며 인스턴스 템플릿을 지정하여 만든 미래용 예약의 경우 다음 속성을 수정하도록 요청할 수 있습니다.

자동 삭제
설명
이름 프리픽스
공유 설정
예약 기간의 시작 및 종료 시간
총 개수(VM 수)^†

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

gcloud CLI 및 REST를 사용하여 인스턴스 템플릿을 지정하면 생성된 미래용 예약을 수정하도록 Google Cloud에 요청할 수 있습니다.

콘솔

Google Cloud에 인스턴스 템플릿을 지정하여 생성된 승인 또는 조달 중인 미래용 예약을 수정하도록 요청하려면 다음 단계를 따르세요.

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

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

선택한 미래용 예약의 세부정보 페이지가 열립니다.
미래용 예약의 자동 삭제 옵션 및 설명을 수정하려면 다음 중 하나 이상을 수행합니다.
- 자동 생성된 예약 자동 삭제 시간 행에서 수정을 클릭한 후 다음 단계를 따릅니다.
  1. 다음 중 하나를 수행합니다.
    - Compute Engine이 미래용 예약 요청을 위해 자동 생성된 예약을 자동으로 삭제하도록 하려면 다음 안내를 따르세요.
      
      주의: 자동 삭제 옵션이 사용 설정된 경우 자동 생성된 모든 예약은 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
      1. 자동 삭제 사용 설정 전환 버튼을 클릭하여 사용 위치로 전환합니다.
      2. 선택사항: 자동 삭제 시간 필드에 자동 생성된 예약을 삭제할 새로운 날짜와 시간을 입력합니다. 날짜와 시간은 예약 기간의 종료 시간 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
    - 그렇지 않으면 자동 삭제 사용 설정 전환 버튼을 클릭하여 해제 위치로 전환합니다.
  2. 제출을 클릭합니다.
- 프리픽스 행에서 수정을 클릭한 후 다음을 수행합니다.
  1. 프리픽스 필드에 새 이름 프리픽스를 입력합니다.
  2. 제출을 클릭합니다.
- 설명 행에서 수정을 클릭한 후 다음을 수행합니다.
  1. 설명 필드에 새 설명을 입력합니다.
  2. 제출을 클릭합니다.
수정을 클릭합니다.

선택한 미래용 예약을 수정하는 페이지가 열립니다.
다른 속성을 수정하려면 다음 중 하나 이상을 수행합니다.
- 미래용 예약의 시작 시간 또는 종료 시간을 수정합니다. 다음 사항이 마련되어 있는지 확인하세요.
  - 시작 시간은 검토를 위해 미래용 예약을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다.
  - 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 시작 시간에 권장되는 값을 지정합니다.
  - 검토를 위해 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 권장 최소 예약 기간을 지정합니다.
- 공유 유형 섹션에서 로컬 또는 공유를 선택할 수 있습니다. 공유를 선택하면 미래용 예약을 공유할 프로젝트를 추가하거나 삭제할 수 있습니다.
  
  프로젝트는 최대 100개까지 선택할 수 있습니다. 이러한 프로젝트는 미래용 예약이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.
- VM 인스턴스 수에 해당 기간 동안 예약하려는 VM의 총 개수, VM 구성 및 미래용 예약에 지정된 프로젝트를 입력합니다.
  
  승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.
  
  주의: 예약할 VM 수를 늘리려면 예약을 요청할 추가 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.
검토를 위해 Google Cloud에 수정 요청을 제출하려면 제출을 클릭합니다.

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

gcloud

Google Cloud에 인스턴스 템플릿을 지정하여 생성된 승인 또는 조달 중인 미래용 예약을 수정하도록 요청하려면 gcloud beta compute future-reservations update 명령어를 사용합니다.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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: 기존 승인 또는 미래용 조달 예약의 이름입니다.

DESCRIPTION: 선택사항. 미래용 예약에 대한 새로운 설명입니다.

NAME_PREFIX: 선택사항. 미래용 예약을 위한 새 이름 프리픽스입니다. 이 미래용 예약에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약을 Google Cloud에 제출하여 검토를 받을 수 있습니다.

PROJECT_ID: 선택사항. 미래용 예약이 생성된 프로젝트의 ID입니다. 단일 프로젝트 미래용 예약을 공유 미래용 예약으로 수정하면 이 프로젝트는 미래용 예약의 소유자 프로젝트가 됩니다. --project 플래그를 생략하면 값이 현재 프로젝트의 ID로 설정됩니다.

SHARE_SETTING: 선택사항. 이 미래용 예약의 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약을 공유된 미래용 예약으로 변경하려면 projects를 지정합니다. --share-with 플래그를 사용하여 소비자 프로젝트를 최소 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
- 그렇지 않은 경우 local을 지정합니다.
  
  중요: local을 지정할 경우 --share-with 플래그를 생략해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
CONSUMER_PROJECT_IDS: 선택사항. 이 미래용 예약을 공유할 수 있는 프로젝트의 프로젝트 ID를 쉼표로 구분한 목록입니다. 예를 들어 project-1,project-2를 지정합니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.
START_TIME: 선택사항. 다음과 같이 표시해야 하는 RFC 3339 타임스탬프 형식의 예약 기간의 새 시작 시간입니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
다음을 바꿉니다.
- YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
- HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
- OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
시작 시간은 검토를 위해 미래용 예약을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 승인 후 또는 잠금 시간을 시작하기 전에 미래용 예약을 취소, 삭제 또는 수정할 수 있는 충분한 시간을 확보하려면 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 --end-time 플래그를 --duration=END_DURATION 플래그로 바꿀 수 있습니다. 여기서 END_DURATION은 예약 기간(초)입니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.

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

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.

주의: 예약할 VM 수를 늘리려면 예약을 요청할 추가 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.

ZONE: 미래용 예약이 있는 영역입니다.

Compute Engine이 예약 기간이 종료된 후 자동 생성된 예약을 자동으로 삭제할 수 있도록 하려면 다음 방법 중 하나를 선택합니다.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 종료 시간(기본값) 후 2시간 내에 예약을 삭제하려면 --auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- 예약 기간 종료 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-delete-time 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.
- 예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-duration 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.
Compute Engine이 자동 생성된 예약을 자동으로 삭제하지 않도록 하려면 --no-auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

예를 들어 이름이 fr-05이고 us-central1-a 영역에 있는 승인된 미래용 예약을 가정해 보겠습니다. 다음 사항을 변경하여 이 미래용 예약을 수정하기 위해 Google Cloud에 요청한다고 가정해 보겠습니다.

예약 기간의 종료 시간을 2023년 12월 31일 자정(UTC)으로 변경합니다.
VM 10개를 예약합니다.
새 이름 프리픽스를 지정합니다.

Google Cloud에 fr-05를 수정하도록 요청하려면 다음 명령어를 실행합니다.

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Google Cloud에 인스턴스 템플릿을 지정하여 생성된 승인 또는 조달 중인 미래용 예약을 수정하도록 요청하려면 beta.futureReservations.update 메서드에 PATCH 요청을 실행합니다. updateMask 쿼리 매개변수에서 업데이트할 각 필드를 지정합니다. 예약에서 선택적 필드를 삭제해야 하는 경우 updateMask 쿼리 매개변수에 해당 필드를 포함하고 요청 본문에서 해당 필드를 생략합니다.

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": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

다음을 바꿉니다.

PROJECT_ID: 미래용 예약이 있는 프로젝트의 ID입니다.
ZONE: 미래용 예약이 있는 영역입니다.
FUTURE_RESERVATION_NAME: 기존 승인 또는 미래용 조달 예약의 이름입니다. 미래용 예약 이름은 수정할 수 없습니다.
UPDATE_FIELDS: 이 PATCH 요청에서 업데이트할 쉼표로 구분된 필드 목록입니다. 각 쉼표를 %2C로 인코딩해야 합니다. 예를 들어 미래용 예약에서 autoDeleteAutoCreatedReservations, totalCount, endTime 필드를 업데이트하려면 다음을 지정합니다.
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 선택사항. 이 필드를 true로 설정하면 Compute Engine이 이 미래용 예약에 대해 자동 생성된 예약을 자동으로 삭제합니다. 기본적으로 삭제 시간은 예약 기간의 종료 시간에서 2시간 이내입니다. 이를 변경하려면 다음 중 하나를 수행하세요.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 예약 기간이 종료된 후 특정 시간에 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDeleteTime 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  DELETE_TIME을 Compute Engine에서 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 다음과 같은 RFC 3339 타임스탬프 형식이어야 합니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  다음을 바꿉니다.
  - YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
  - HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
  - OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
- 예약 기간의 시작 시간에서 특정 기간이 지난 후 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDuration 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.
DESCRIPTION: 선택사항. 이 미래용 예약 요청에 대한 설명을 업데이트하려면 다음 중 하나를 수행합니다.
- 설명을 추가하거나 업데이트하려면 설명을 지정합니다.
- 설명을 삭제하려면 요청 본문에서 description 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.
NAME_PREFIX: 선택사항. 미래용 예약을 위한 새 이름 프리픽스입니다. 이 미래용 예약에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약을 Google Cloud에 제출하여 검토를 받을 수 있습니다.
SHARE_TYPE: 선택사항. 이 미래용 예약의 공유 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약을 공유된 미래용 예약으로 변경하려면 SPECIFIC_PROJECTS를 지정합니다. 또한 projects 필드에 소비자 프로젝트를 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
- 그렇지 않은 경우 LOCAL을 지정합니다. 또한 요청 본문에서 projects 필드를 삭제하고 UPDATE_FIELDS에 지정해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 선택사항. 공유된 미래용 예약을 공유할 수 있는 프로젝트의 프로젝트 ID입니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.

TOTAL_COUNT: 선택사항. 이 미래용 예약 요청에 지정된 기간, VM 구성, 프로젝트에 예약하려는 총 VM 수입니다.

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약할 VM 수를 늘리려면 예약을 요청할 추가 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.
START_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새 시작 시간입니다. 시작 시간은 검토를 위해 미래용 예약을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 또한 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 endTime 필드를 duration 필드로 바꿔서 예약 기간의 시작 시간으로부터 특정 기간을 지정할 수 있습니다.
```
"duration": {
  "seconds": "END_DURATION"
}
```
END_DURATION을 초 단위의 기간으로 바꿉니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.

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

예약 기간의 종료 시간을 2023년 12월 31일 자정(UTC)으로 변경합니다.
VM 10개를 예약합니다.
새 이름 프리픽스를 지정합니다.

Google Cloud에 fr-05를 수정하도록 요청하려면 다음 PATCH 요청을 수행합니다.

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Google Cloud에 미래용 예약 수정 요청을 제출한 후에는 미래용 예약의 세부정보를 확인하여 요청 상태를 모니터링할 수 있습니다.

속성을 직접 지정하여 생성된 미래용 예약 수정 요청

조달 상태가 승인됨(APPROVED) 또는 조달 중(Procuring)이며 직접 속성을 지정하여 만든 미래용 예약의 경우 다음 속성을 수정하도록 요청할 수 있습니다.

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

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

Google Cloud 콘솔, gcloud CLI, REST를 사용하여 속성을 직접 지정하면 생성된 미래용 예약을 수정하도록 Google Cloud에 요청할 수 있습니다.

콘솔

Google Cloud에 직접 속성을 지정하여 생성된 승인 또는 조달 미래용 예약을 수정하도록 요청하려면 다음 단계를 따르세요.

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

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

선택한 미래용 예약의 세부정보 페이지가 열립니다.
미래용 예약의 자동 삭제 옵션 및 설명을 수정하려면 다음 중 하나 이상을 수행합니다.
- 자동 생성된 예약 자동 삭제 시간 행에서 수정을 클릭한 후 다음 단계를 따릅니다.
  1. 다음 중 하나를 수행합니다.
    - Compute Engine이 미래용 예약 요청을 위해 자동 생성된 예약을 자동으로 삭제하도록 하려면 다음 안내를 따르세요.
      
      주의: 자동 삭제 옵션이 사용 설정된 경우 자동 생성된 모든 예약은 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
      1. 자동 삭제 사용 설정 전환 버튼을 클릭하여 사용 위치로 전환합니다.
      2. 선택사항: 자동 삭제 시간 필드에 자동 생성된 예약을 삭제할 새로운 날짜와 시간을 입력합니다. 날짜와 시간은 예약 기간의 종료 시간 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
    - 그렇지 않으면 자동 삭제 사용 설정 전환 버튼을 클릭하여 해제 위치로 전환합니다.
  2. 제출을 클릭합니다.
- 프리픽스 행에서 수정을 클릭한 후 다음을 수행합니다.
  1. 프리픽스 필드에 새 이름 프리픽스를 입력합니다.
  2. 제출을 클릭합니다.
- 설명 행에서 수정을 클릭한 후 다음을 수행합니다.
  1. 설명 필드에 새 설명을 입력합니다.
  2. 제출을 클릭합니다.
수정을 클릭합니다.

선택한 미래용 예약을 수정하는 페이지가 열립니다.
다른 속성을 수정하려면 다음 중 하나 이상을 수행합니다.
- 미래용 예약의 시작 시간 또는 종료 시간을 수정합니다. 다음 사항이 마련되어 있는지 확인하세요.
  - 시작 시간은 검토를 위해 미래용 예약을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다.
  - 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 시작 시간에 권장되는 값을 지정합니다.
  - 검토를 위해 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 권장 최소 예약 기간을 지정합니다.
- 공유 유형 섹션에서 로컬 또는 공유를 선택할 수 있습니다. 공유를 선택하면 미래용 예약을 공유할 프로젝트를 추가하거나 삭제할 수 있습니다.
  
  프로젝트는 최대 100개까지 선택할 수 있습니다. 이러한 프로젝트는 미래용 예약이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.
- VM 인스턴스 수에 해당 기간 동안 예약하려는 VM의 총 개수, VM 구성 및 미래용 예약에 지정된 프로젝트를 입력합니다.
  
  승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.
  
  주의: 예약할 VM 수를 늘리려면 예약을 요청할 추가 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.
- 머신 구성 섹션에서 다음을 변경할 수 있습니다.
  - 예약된 VM에 사용되는 머신 계열 및 머신 유형
  - 예약된 VM에 연결할 GPU
  - 예약된 VM의 로컬 SSD 및 디스크 인터페이스 유형
검토를 위해 Google Cloud에 수정 요청을 제출하려면 제출을 클릭합니다.

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

gcloud

Google Cloud에 직접 속성을 지정하여 생성된 승인 또는 조달 중인 미래용 예약을 수정하도록 요청하려면 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_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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: 기존 승인 또는 미래용 조달 예약의 이름입니다.

선택사항입니다. 다음 중 하나를 수행합니다.
- 예약된 각 VM에 그래픽 처리 장치(GPU)를 추가하려면 다음을 지정합니다.
  - NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수입니다.
  - ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형입니다.
  미래용 예약에서 지정한 머신 유형이 지정한 GPU 유형을 지원하는지, 그리고 리소스를 예약하려는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 오류가 발생합니다.
- 이 미래용 예약에서 모든 GPU를 삭제하려면 --accelerator 플래그를 --clear-accelerator 플래그로 바꿉니다.

DESCRIPTION: 선택사항. 미래용 예약에 대한 새로운 설명입니다.

선택사항입니다. 다음 중 하나를 수행합니다.
- 각 VM에서 로컬 SSD에 사용할 인터페이스 유형을 추가하거나 수정하려면 INTERFACE_1 및 INTERFACE_2를 바꿉니다. 값은 다음 중 하나여야 합니다.
  - 부팅 디스크 이미지에 최적화된 NVMe 드라이버가 있는 경우 nvme를 지정합니다.
  - 그렇지 않은 경우 scsi을 지정합니다.
  각 로컬 SSD는 375GB입니다. 추가하려는 각 로컬 SSD에 대해 --local-ssd 플래그를 반복합니다. 최대 24개의 로컬 SSD를 지정할 수 있습니다.
- 이 미래용 예약에서 모든 로컬 SSD를 삭제하려면 모든 --local-ssd 플래그를 삭제하고 --clear-local-ssd 플래그를 지정합니다.
MACHINE_TYPE: 선택사항. 각 VM에 사용할 사전 정의된 또는 커스텀 머신 유형입니다. 커스텀 머신 유형을 지정하기 전에 커스텀 머신 유형의 VM에 대한 제한사항을 검토하세요.

참고: 이전에 지정한 머신 계열과 다른 머신 계열을 지정하는 경우 지정한 머신 계열의 권장 최소 예약 기간을 지정해야 합니다. 그렇지 않으면 Google Cloud가 요청을 승인할 가능성이 낮습니다.
MINIMUM_CPU_PLATFORM: 선택사항. 각 VM에 사용할 최소 CPU 플랫폼입니다. --min-cpu-platform 플래그를 생략하면 값이 영역의 기본 CPU 플랫폼으로 설정됩니다.

NAME_PREFIX: 선택사항. 미래용 예약을 위한 새 이름 프리픽스입니다. 이 미래용 예약에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약을 Google Cloud에 제출하여 검토를 받을 수 있습니다.

PROJECT_ID: 선택사항. 미래용 예약이 생성된 프로젝트의 ID입니다. 단일 프로젝트 미래용 예약을 공유 미래용 예약으로 수정하면 이 프로젝트는 미래용 예약의 소유자 프로젝트가 됩니다. --project 플래그를 생략하면 값이 현재 프로젝트의 ID로 설정됩니다.

SHARE_SETTING: 선택사항. 이 미래용 예약의 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약을 공유된 미래용 예약으로 변경하려면 projects를 지정합니다. --share-with 플래그를 사용하여 소비자 프로젝트를 최소 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약 요청이 수정되지 않습니다.
- 그렇지 않은 경우 local을 지정합니다.
  
  중요: local을 지정할 경우 --share-with 플래그를 생략해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
CONSUMER_PROJECT_IDS: 선택사항. 이 미래용 예약을 공유할 수 있는 프로젝트의 프로젝트 ID를 쉼표로 구분한 목록입니다. 예를 들어 project-1,project-2를 지정합니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.
START_TIME: 선택사항. 다음과 같이 표시해야 하는 RFC 3339 타임스탬프 형식의 예약 기간의 새 시작 시간입니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
다음을 바꿉니다.
- YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
- HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
- OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
시작 시간은 검토를 위해 미래용 예약을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 승인 후 또는 잠금 시간을 시작하기 전에 미래용 예약을 취소, 삭제 또는 수정할 수 있는 충분한 시간을 확보하려면 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 --end-time 플래그를 --duration=END_DURATION 플래그로 바꿀 수 있습니다. 여기서 END_DURATION은 예약 기간(초)입니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.

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

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud에서 미래용 예약 요청을 거부합니다.

주의: 예약할 VM 수를 늘리려면 예약을 요청할 추가 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.

ZONE: 미래용 예약이 있는 영역입니다.

Compute Engine이 예약 기간이 종료된 후 자동 생성된 예약을 자동으로 삭제할 수 있도록 하려면 다음 방법 중 하나를 선택합니다.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 종료 시간(기본값) 후 2시간 내에 예약을 삭제하려면 --auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- 예약 기간 종료 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-delete-time 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.
- 예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-delete-auto-created-reservations 및 --auto-created-reservations-duration 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.
Compute Engine이 자동 생성된 예약을 자동으로 삭제하지 않도록 하려면 --no-auto-delete-auto-created-reservations 플래그를 지정합니다.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

예약 기간의 종료 시간을 2023년 12월 31일 자정(UTC)으로 변경합니다.
VM 10개를 예약합니다.
새 이름 프리픽스를 지정합니다.

Google Cloud에 fr-05를 수정하도록 요청하려면 다음 명령어를 실행합니다.

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Google Cloud에 속성을 직접 지정하여 생성된 승인 또는 조달 중인 미래용 예약을 수정하도록 요청하려면 beta.futureReservations.update 메서드에 PATCH 요청을 실행합니다. updateMask 쿼리 매개변수에서 업데이트할 각 필드를 지정합니다. 예약에서 선택적 필드를 삭제해야 하는 경우 updateMask 쿼리 매개변수에 해당 필드를 포함하고 요청 본문에서 해당 필드를 생략합니다.

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: 이 PATCH 요청에서 업데이트할 쉼표로 구분된 필드 목록입니다. 각 쉼표를 %2C로 인코딩해야 합니다. 예를 들어 미래용 예약에서 autoDeleteAutoCreatedReservations, totalCount, endTime 필드를 업데이트하려면 다음을 지정합니다.
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 선택사항. 이 필드를 true로 설정하면 Compute Engine이 이 미래용 예약에 대해 자동 생성된 예약을 자동으로 삭제합니다. 기본적으로 삭제 시간은 예약 기간의 종료 시간에서 2시간 이내입니다. 이를 변경하려면 다음 중 하나를 수행하세요.

주의: 자동 삭제 옵션을 사용 설정하면 자동 생성된 모든 예약이 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
- 예약 기간이 종료된 후 특정 시간에 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDeleteTime 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  DELETE_TIME을 Compute Engine에서 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 다음과 같은 RFC 3339 타임스탬프 형식이어야 합니다.
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  다음을 바꿉니다.
  - YYYY-MM-DD: 4자리 연도, 2자리 월, 2자리 일이 하이픈(-)으로 구분된 형식의 날짜입니다.
  - HH:MM:SS: 24시간제의 2자리 시간, 2자리 분, 2자리 초가 콜론(:)으로 구분된 형식의 시간입니다.
  - OFFSET: 협정 세계시(UTC)의 오프셋 형식으로 지정된 시간대입니다. 예를 들어 태평양 표준시(PST)를 사용하려면 -08:00을 지정합니다. 또는 오프셋을 사용하지 않으려면 Z를 지정합니다.
- 예약 기간의 시작 시간에서 특정 기간이 지난 후 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDuration 필드를 지정합니다.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.
DESCRIPTION: 선택사항. 이 미래용 예약 요청에 대한 설명을 업데이트하려면 다음 중 하나를 수행합니다.
- 설명을 추가하거나 업데이트하려면 설명을 지정합니다.
- 설명을 삭제하려면 요청 본문에서 description 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.
NAME_PREFIX: 선택사항. 미래용 예약을 위한 새 이름 프리픽스입니다. 이 미래용 예약에 대해 자동으로 생성된 각 예약의 이름은 이름 프리픽스로 시작합니다. 미래용 예약에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

PLANNING_STATUS: 미래용 예약의 계획 상태입니다. SUBMITTED만 지정하여 미래용 예약을 Google Cloud에 제출하여 검토를 받을 수 있습니다.
SHARE_TYPE: 선택사항. 이 미래용 예약의 공유 유형을 변경하려면 다음 값 중 하나를 지정합니다.
- 단일 프로젝트 미래용 예약을 공유된 미래용 예약으로 변경하려면 SPECIFIC_PROJECTS를 지정합니다. 또한 projects 필드에 소비자 프로젝트를 하나 이상 지정해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
- 그렇지 않은 경우 LOCAL을 지정합니다. 또한 요청 본문에서 projects 필드를 삭제하고 UPDATE_FIELDS에 지정해야 합니다. 그렇지 않으면 미래용 예약이 수정되지 않습니다.
CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 선택사항. 공유된 미래용 예약을 공유할 수 있는 프로젝트의 프로젝트 ID입니다. 최대 100개의 항목을 지정할 수 있으며 이러한 프로젝트는 미래용 예약이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약에 대해 자동 생성된 공유 예약을 사용할 수 있습니다.

선택사항입니다. 예약된 각 VM에 연결된 그래픽 처리 장치(GPU)를 업데이트하려면 다음 중 하나를 수행합니다.
- GPU를 추가하거나 수정하려면 다음을 지정합니다.
  - NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수입니다.
  - ACCELERATOR_TYPE: 예약된 VM에 추가할 GPU 유형입니다.
  미래용 예약에서 지정한 머신 유형이 지정한 GPU 유형을 지원하는지, 그리고 리소스를 예약하려는 영역에서 GPU를 사용할 수 있는지 확인합니다. 그렇지 않으면 오류가 발생합니다.
- 이 미래용 요청에서 모든 GPU를 삭제하려면 요청 본문에서 guestAccelerators 필드를 생략하고 UPDATE_FIELDS에 지정합니다.
선택사항입니다. 예약된 각 VM에 연결된 로컬 SSD를 업데이트하려면 다음 중 하나를 수행합니다.
- 각 VM에서 로컬 SSD에 사용할 인터페이스 유형을 추가하거나 수정하려면 INTERFACE_1 및 INTERFACE_2를 바꿉니다. 값은 다음 중 하나여야 합니다.
  - 부팅 디스크 이미지에 최적화된 NVMe 드라이버가 있는 경우 NVME를 지정합니다.
  - 그렇지 않은 경우 SCSI을 지정합니다.
  추가 또는 업데이트할 각 로컬 SSD에 대해 diskSizeGb 및 interface 필드를 반복합니다. 최대 24개의 로컬 SSD를 지정할 수 있습니다.
- 이 미래용 요청 예약에서 모든 로컬 SSD를 삭제하려면 요청 본문에서 localSsds 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.
MACHINE_TYPE: 선택사항. 각 VM에 사용할 사전 정의된 또는 커스텀 머신 유형입니다. 커스텀 머신 유형을 지정하기 전에 커스텀 머신 유형의 VM에 대한 제한사항을 검토하세요.

참고: 이전에 지정한 머신 계열과 다른 머신 계열을 지정하는 경우 지정한 머신 계열의 권장 최소 예약 기간을 지정해야 합니다. 그렇지 않으면 Google Cloud가 요청을 승인할 가능성이 낮습니다.
MINIMUM_CPU_PLATFORM: 선택사항. 각 VM에 사용할 최소 CPU 플랫폼을 업데이트하려면 다음 중 하나를 수행합니다.
- 최소 CPU 플랫폼을 추가하거나 업데이트하려면 최소 CPU 플랫폼을 지정합니다.
- 영역의 기본 CPU 플랫폼으로 되돌리려면 요청 본문에서 minCpuPlatform 필드를 삭제하고 UPDATE_FIELDS에 지정합니다.

TOTAL_COUNT: 선택사항. 이 미래용 예약 요청에 지정된 기간, VM 구성, 프로젝트에 예약하려는 총 VM 수입니다.

승인된 미래용 예약을 위해 생성할 예약 수를 계산할 때 Compute Engine은 먼저 기존 예약을 확인합니다. 승인된 미래용 예약과 일치하는 기존 예약이 있는 경우 Compute Engine이 생성하는 새 예약 수를 결정하기 위해 요청의 요청된 총 예약 수에서 기존 예약 수를 뺍니다. 자세한 내용은 Compute Engine에서 예약된 리소스 수를 계산 및 프로비저닝하는 방법을 참조하세요.

주의: 예약할 VM 수를 늘리려면 예약을 요청할 추가 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 Google Cloud가 수정 요청을 거부합니다.
START_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새 시작 시간입니다. 시작 시간은 검토를 위해 미래용 예약을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 또한 미래용 예약이 잠금 시간에 들어가기 전에 충분한 시간을 확보할 수 있도록 권장 시작 시간을 지정해야 합니다.
END_TIME: 선택사항. RFC 3339 타임스탬프 형식으로 된 예약 기간의 새로운 종료 시간입니다. 예약 기간은 최소 24시간 이상이어야 합니다. 또는 endTime 필드를 duration 필드로 바꿔서 예약 기간의 시작 시간으로부터 특정 기간을 지정할 수 있습니다.
```
"duration": {
  "seconds": "END_DURATION"
}
```
END_DURATION을 초 단위의 기간으로 바꿉니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.

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

예약 기간의 종료 시간을 2023년 12월 31일 자정(UTC)으로 변경합니다.
VM 10개를 예약합니다.
새 이름 프리픽스를 지정합니다.

Google Cloud에 fr-05를 수정하도록 요청하려면 다음 PATCH 요청을 수행합니다.

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Google Cloud에 미래용 예약 수정 요청을 제출한 후에는 미래용 예약의 세부정보를 확인하여 요청 상태를 모니터링할 수 있습니다.

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

조달 상태가 조달 중(PROCURING)에 도달하기 전에 미래용 예약 요청의 다른 속성을 변경하려면 다음 단계를 수행합니다.

다음 중 하나 이상을 수행합니다.
- Google Cloud가 미래용 예약 요청을 검토하지 못하도록 하려면 미래용 예약 요청을 취소합니다.
- 미래용 예약 요청이 현재 프로젝트 또는 미래용 예약 요청이 공유되는 프로젝트에서 만들 수 있는 미래용 예약 요청 유형을 제한하지 않도록 하려면 미래용 예약 요청을 삭제합니다.
원하는 업데이트와 함께 새 단일 프로젝트 또는 공유 미래용 예약 요청을 만듭니다.

문제 해결

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

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

미래용 예약 요청 취소

승인, 거부 또는 승인 대기 중인 미래용 예약 요청을 취소하여 Google Cloud가 요청된 용량을 프로비저닝하지 않도록 할 수 있습니다. 미래용 예약 요청을 취소한 후에는 세부정보를 보거나 삭제만 할 수 있습니다.

gcloud CLI와 REST를 사용하여 미래용 예약 요청을 취소할 수 있습니다.

gcloud

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

gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

다음을 바꿉니다.

FUTURE_RESERVATION_NAME: 기존 미래용 예약 요청의 이름입니다.
PROJECT_ID: 선택사항. 미래용 예약 요청이 있는 프로젝트의 ID입니다. --project 플래그를 생략하면 현재 프로젝트의 ID가 사용됩니다.
ZONE: 미래용 예약 요청이 있는 영역입니다.

REST

미래용 예약 요청을 취소하려면 beta.futureReservations.cancel 메서드에 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

다음을 바꿉니다.

PROJECT_ID: 미래용 예약 요청이 있는 프로젝트의 ID입니다.
ZONE: 미래용 예약 요청이 있는 영역입니다.
FUTURE_RESERVATION_NAME: 기존 미래용 예약 요청의 이름입니다.

미래용 예약 요청 삭제

다음 중 한 가지 경우에만 미래용 예약 요청을 삭제할 수 있습니다.

미래용 예약 요청이 취소되었습니다.
미래용 예약이 예약 기간의 시작 시간에 도달하기 전에
미래용 예약이 예약 기간의 종료 시간에 도달한 후

미래용 예약을 삭제해도 미래용 예약에 대해 자동 생성된 예약은 삭제되지 않습니다. 예약 기간이 끝난 후 자동 생성된 예약을 삭제하려면 대신 예약 삭제를 참조하세요.

Google Cloud 콘솔, gcloud CLI, REST를 사용하여 미래용 예약 요청을 삭제할 수 있습니다.

콘솔

미래용 예약 요청을 삭제하려면 다음 단계를 수행합니다.

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

예약으로 이동
미래용 예약 탭을 클릭합니다.
삭제할 각 미래용 예약 요청 옆에 있는 체크박스를 선택합니다.
예약 삭제를 클릭합니다.
삭제를 클릭하여 확인합니다.

미래용 예약 요청을 삭제하는 데 최대 1분이 걸릴 수 있습니다.

gcloud

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

gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

다음을 바꿉니다.

FUTURE_RESERVATION_NAME: 기존 미래용 예약 요청의 이름입니다.
PROJECT_ID: 선택사항. 미래용 예약 요청이 있는 프로젝트의 ID입니다. --project 플래그를 생략하면 현재 프로젝트의 ID가 사용됩니다.
ZONE: 미래용 예약 요청이 있는 영역입니다.

REST

미래용 예약 요청을 삭제하려면 beta.futureReservations.delete 메서드에 DELETE 요청을 실행합니다.

DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

다음을 바꿉니다.

PROJECT_ID: 미래용 예약 요청이 있는 프로젝트의 ID입니다.
ZONE: 미래용 예약 요청이 있는 영역입니다.
FUTURE_RESERVATION_NAME: 기존 미래용 예약 요청의 이름입니다.

다음 단계

미래용 예약 요청을 보는 방법 알아보기
예약 기간의 시작 시간에 도달한 후 자동 생성된 예약 사용 방법 알아보기
예약 기간의 종료 시간 후 다음을 수행하는 방법 알아보기
- 자동 생성된 예약 수정
- 자동 생성된 예약 삭제