공유 미래용 예약 요청 만들기

이 문서에서는 공유 미래용 예약 요청을 만드는 방법을 설명합니다.

Google Cloud가 공유 미래용 예약 요청을 승인하면 요청에 지정된 시작 시간에 Compute Engine이 여러 프로젝트 간에 공유되는 예약을 자동으로 만듭니다. 이렇게 자동 생성된 공유 예약은 미래용 예약(소유자 프로젝트)을 호스팅하는 프로젝트 및 미래용 예약이 공유되는 프로젝트(소비자 프로젝트)의 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.futureReservationUser) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 공유 미래용 예약 요청을 만드는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

공유 미래용 예약 요청을 만들려면 다음 권한이 필요합니다.

미래용 예약 요청 만들기: 프로젝트에 대한 compute.futureReservations.create 권한
Compute Engine에서 예약을 자동으로 만들도록 허용: 프로젝트에 대한 compute.reservations.create
인스턴스 템플릿을 지정하려는 경우: 인스턴스 템플릿에 대한 compute.instanceTemplates.useReadOnly 권한

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

제한사항

미래용 예약에 대한 일반적인 제한사항 외에도 공유 미래용 예약 요청을 만들 때는 다음 제한사항이 적용됩니다.

조직 정책 관리자가 공유 미래용 예약 요청을 만들기 위해 사용되는 프로젝트(소유자 프로젝트)를 공유 예약 소유자 프로젝트(compute.sharedReservationsOwnerProjects) 조직 정책 제약조건의 허용 목록에 추가해야 합니다. 자세한 내용은 Compute Engine 예약 문서에서 공유 예약 만들기 및 수정을 위한 프로젝트 허용 및 제한을 참조하세요.
공유 미래용 예약 요청을 만든 프로젝트를 다른 조직으로 이동하면 공유 미래용 예약이 삭제됩니다. 프로젝트가 공유 예약 소유자 프로젝트(compute.sharedReservationsOwnerProjects) 조직 정책 제약조건에서 자동으로 삭제되지 않지만, 원하는 경우 이 제약조건에서 프로젝트를 삭제할 수 있습니다.
각 공유 미래용 예약 요청은 최대 100개의 소비자 프로젝트에 공유할 수 있습니다.
각 조직에서는 각각의 고유한 VM 속성 조합에 대해 최대 100개까지 공유 미래용 예약 요청을 만들 수 있습니다.

초안 요청 만들기

미래용 예약 요청을 만들 때 요청을 초안으로 저장한 후에 나중에 검토를 위해 Google Cloud에 제출하거나 검토를 위해 요청을 직접 제출할 수 있습니다. 먼저 초안 요청을 만드는 것이 좋습니다. 이렇게 하면 수치를 수동으로 추정하는 대신 Compute Engine에서 요청에 프로비저닝할 VM 수를 결정하고, 원하는 경우 요청을 검토를 위해 제출하기 전에 요청에서 예약된 VM 수를 수정할 수 있습니다.

미래용 예약에 자동 생성된 예약을 사용하려면 VM에 해당 예약과 정확히 일치하는 속성이 있어야 합니다. 미래용 예약 요청 초안을 만들어 예약하려는 VM의 속성을 지정하려면 다음 메서드 중 하나를 사용합니다.

권장사항: 인스턴스 템플릿 지정

기존 인스턴스 템플릿을 사용하여 미래용 예약 요청 초안의 속성을 정의할 수 있습니다. 인스턴스 템플릿을 사용하면 미래용 예약 요청의 속성과 동일한 위치에서 자동 생성된 예약을 사용할 수 있는 VM을 정의할 수 있습니다. 그러나 템플릿이 프로젝트에 한정되므로 동일한 템플릿을 사용해서 미래용 예약 요청을 만든 프로젝트 외부에서 자동 생성된 예약을 사용할 수 있는 VM을 만들 수는 없습니다. 미래용 예약이 공유된 프로젝트의 경우 해당 프로젝트에서 유사한 템플릿을 만들거나 속성을 직접 지정하여 VM을 만들어야 합니다.
기존 VM 지정

기존 VM을 사용하여 미래용 예약 요청의 속성을 정의할 수 있습니다. 기존 VM 속성을 사용하면 참조 VM과 일치하는 속성이 있는 VM을 만들어 미래용 예약에 프로비저닝된 자동 생성된 예약을 사용할 수 있습니다.
속성 직접 지정

미래용 예약 요청 초안의 속성을 직접 정의할 수 있습니다. 이 방법을 사용하려면 VM의 속성 및 자동 생성된 예약이 정확히 일치하는지 수동으로 확인해야 합니다. 일치하지 않는 속성이 하나라도 있으면 사용할 수 없습니다.

미래용 예약을 위해 자동으로 생성된 예약은 일치하는 속성이 있는 모든 VM에서 자동으로 사용될 수 있습니다. VM이 이러한 자동 생성된 예약을 사용하지 않도록 방지하려면 예약을 사용하지 않고 VM 만들기 방법을 참조하세요.

인스턴스 템플릿 지정

인스턴스 템플릿을 지정하여 공유 미래용 예약 요청을 만들 때는 다음 사항을 고려하세요.

인스턴스 템플릿에는 프로젝트별 설정이 포함되어 있으므로 동일한 프로젝트 내의 인스턴스 템플릿에만 액세스하고 사용할 수 있습니다. 인스턴스 템플릿을 지정하여 공유 미래용 예약 요청을 만드는 경우 VM을 만들기 위해 비슷한 템플릿을 만들거나 일치하는 속성을 직접 지정하여 VM을 만들어서 각 소비자 프로젝트에서 자동 생성된 예약을 사용하도록 해야 합니다.
인스턴스 템플릿 내의 리소스와 동일한 리전 및 영역에 미래용 예약 요청을 만들어야 합니다. 인스턴스 템플릿(예: 머신 유형 또는 디스크)에 지정된 모든 리전별 리소스 또는 영역별 리소스는 템플릿 사용을 해당 리소스의 위치로 제한합니다. 예를 들어 인스턴스 템플릿이 us-central1-a 영역에 기존 Persistent Disk를 지정한 경우 같은 영역에 미래용 예약 요청을 만들어야 합니다. 그렇지 않으면 미래용 예약 요청을 만들 수 없습니다.

기존 템플릿이 템플릿을 특정 리전 또는 영역에 결합하는 리소스를 지정하는지 확인하려면 템플릿에 대한 세부정보를 보고 해당 템플릿 내에서 리전별 리소스 또는 영역별 리소스에 대한 참조를 확인합니다.
미래용 예약을 위해 프로비저닝된 자동 생성된 예약을 약정에 연결하려면 자동 삭제 옵션을 사용 중지해야 합니다. 자세한 내용은 생성 후 제한사항을 참조하세요.

미래용 예약 요청을 만든 후에는 미래용 예약 요청을 수정하여 템플릿의 VM 속성을 재정의하거나 다른 템플릿을 지정할 수 없습니다. 대신 요청에 지정된 VM 속성을 변경해야 하는 경우 새로운 미래용 예약 요청을 만들어야 합니다.

기존 인스턴스 템플릿을 지정하여 공유 미래용 예약을 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

예약으로 이동
미래용 예약 탭을 클릭합니다.
미래용 예약 만들기를 클릭합니다.

미래용 예약 만들기 페이지가 열립니다.
이름에 미래용 예약 요청을 위한 이름을 입력합니다.
접두사에 이름 접두사를 입력합니다. 이 미래용 예약 요청에서 자동 생성된 각 예약의 이름은 이 접두사로 시작합니다.
리전 및 영역에 리소스를 예약할 리전과 영역을 선택합니다.
시작 시간에 예약 기간의 시작 시간을 입력합니다. 시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 잠금 시간에 들어가기 전에 미래용 예약을 수정, 취소 또는 삭제할 수 있는 충분한 시간을 확보하려면 시작 시간에 권장되는 값을 지정합니다.
종료 시간에 예약 기간의 종료 시간을 입력합니다. 예약 기간은 최소 24시간 이상이어야 합니다.

기간 요약 섹션에서 예약 기간의 길이를 확인할 수 있습니다. 검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.
공유 유형 섹션에서 다음을 수행합니다.
1. 공유 미래용 예약 요청을 지정하려면 공유를 선택합니다.
2. 프로젝트 추가를 클릭하고 미래용 예약 요청을 공유하려는 현재 프로젝트의 조직에서 프로젝트를 선택합니다. 프로젝트는 최대 100개까지 선택할 수 있습니다.
VM 인스턴스 수에 해당 기간 동안 예약하려는 VM의 총 개수, VM 구성, 미래용 예약 요청에 지정된 프로젝트를 입력합니다.

중요: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 검토를 위해 미래용 예약 요청을 제출했을 때 Google Cloud에서 요청을 거부합니다.
머신 구성 섹션에서 다음을 수행합니다.
1. 인스턴스 템플릿 사용을 선택합니다.
2. 인스턴스 템플릿에서 원하는 인스턴스 템플릿을 선택합니다. 리전 인스턴스 템플릿을 선택하면 템플릿의 리전과 동일한 리전 내에서만 리소스를 예약할 수 있습니다.
자동 생성된 예약 자동 삭제 시간 섹션에서 다음 중 하나를 수행합니다.
- Compute Engine이 미래용 예약 요청을 위해 자동 생성된 예약을 자동으로 삭제하도록 하려면 다음 안내를 따르세요.
  
  주의: 자동 삭제 옵션이 사용 설정된 경우 자동 생성된 모든 예약은 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
  1. 아직 사용 설정되지 않은 경우 자동 삭제 사용 설정 전환 버튼을 클릭하여 사용 위치로 전환합니다.
  2. (선택사항) 자동 삭제 시간에 자동 생성된 예약을 삭제할 날짜와 시간을 입력합니다. 날짜와 시간은 예약 기간의 종료 시간보다 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
- 그렇지 않으면 자동 삭제 사용 설정 전환 버튼을 클릭하여 해제 위치로 전환합니다.
미래용 예약 요청 초안 만들기를 완료하려면 초안 저장을 클릭합니다.

예약 페이지가 열립니다. 미래용 예약 요청 만들기를 완료하는 데 최대 1분이 걸릴 수 있습니다.

gcloud

인스턴스 템플릿을 지정하여 공유 미래용 예약 요청을 만들려면 --share-setting=projects 및 --share-with 플래그와 함께 gcloud beta compute future-reservations create 명령어를 사용합니다.

선택적 플래그를 포함하지 않고 인스턴스 템플릿을 지정하여 미래용 예약 요청 초안을 만들고 예약 기간이 끝나면 자동 생성된 예약을 자동으로 삭제하려면 다음 명령어를 실행합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

다음을 바꿉니다.

FUTURE_RESERVATION_NAME: 미래용 예약 요청의 이름
MACHINE_TYPE: 예약된 각 VM에 사용할 머신 유형

CONSUMER_PROJECT_IDS: 이 미래용 예약 요청에 대해 자동 생성된 예약을 사용할 수 있도록 허용할 프로젝트의 ID를 쉼표로 구분한 목록입니다(예: project-1,project-2). 프로젝트는 최대 100개까지 지정할 수 있습니다. 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 예약을 사용할 수 있습니다.

PROJECT_ID: 인스턴스 템플릿이 있고 리소스를 예약하려는 프로젝트의 ID
LOCATION: 인스턴스 템플릿의 위치. 다음 값 중 하나를 지정합니다.
- 리전 인스턴스 템플릿의 경우: regions/REGION. REGION을 인스턴스 템플릿이 있는 리전으로 바꿉니다. 리전 인스턴스 템플릿을 지정하면 템플릿의 리전과 동일한 리전 내에서만 미래용 예약 요청을 만들 수 있습니다.
- 전역 인스턴스 템플릿의 경우: global
INSTANCE_TEMPLATE_NAME: 기존 인스턴스 템플릿의 이름

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의 총 개수
ZONE: 리소스를 예약할 영역

예를 들어 us-central1-a 영역에서 다음 속성을 사용하여 fr-02라는 미래용 예약 요청 초안을 만들려고 한다고 가정해 보겠습니다.

예약 기간은 2024년 11월 10일 자정(UTC)에 시작하여 2024년 12월 10일 자정(UTC)에 종료됩니다.
총 80대의 VM

us-central1 리전의 리전 인스턴스 템플릿입니다.

자동 삭제 옵션이 사용 설정되어 있습니다. 자동 생성된 예약은 예약 기간이 종료되면 삭제됩니다.

미래용 예약 요청이 project-1 및 project-2에 공유됩니다.

fr-02를 만들려면 다음 명령어를 실행합니다.

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

예약 기간의 종료 시간이 지난 후 자동 생성된 예약을 삭제하려면 다음 방법 중 하나를 선택합니다.

예약 기간의 종료 시간이 지난 후 특정 날짜 및 시간에 자동 생성된 예약을 삭제하려면 --auto-created-reservations-delete-time 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.

예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-created-reservations-duration 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.

자동 생성된 예약의 자동 삭제 옵션을 사용 중지하려면 --auto-delete-auto-created-reservations 플래그를 --no-auto-delete-auto-created-reservations 플래그로 대체합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

자동 생성된 예약의 이름 프리픽스를 지정하려면 --name-prefix 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

NAME_PREFIX을 자동으로 생성된 각 예약의 이름 프리픽스로 바꿉니다. 미래용 예약 요청에 대해 자동 생성된 예약을 식별하는 데 도움이 되도록 고유한 이름 프리픽스를 지정하는 것이 좋습니다.

REST

인스턴스 템플릿을 지정하여 공유 미래용 예약 요청을 만들려면 beta.futureReservations.insert 메서드에 POST 요청을 합니다.

선택적 필드를 포함하지 않고 인스턴스 템플릿을 지정하여 미래용 예약 요청 초안을 만들려면 다음과 같이 POST 요청을 실행합니다.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

다음을 바꿉니다.

PROJECT_ID: 인스턴스 템플릿이 있고 리소스를 예약하려는 프로젝트의 ID
ZONE: 리소스를 예약할 영역
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 이 필드를 true로 설정하면 Compute Engine은 예약 기간의 종료 시간부터 2시간 이내에 이 미래용 예약에 대해 자동으로 생성된 예약을 자동으로 삭제합니다. 자동 생성된 예약을 약정에 연결하려면 이 필드를 false로 설정합니다.

CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 이 미래용 예약 요청을 공유할 수 있는 프로젝트의 프로젝트 ID입니다. 프로젝트는 최대 100개까지 지정할 수 있습니다. 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 예약을 사용할 수 있습니다.

LOCATION: 인스턴스 템플릿의 위치입니다. 다음 값 중 하나를 지정합니다.
- 리전 인스턴스 템플릿의 경우: regions/REGION. REGION을 인스턴스 템플릿이 있는 리전으로 바꿉니다. 리전 인스턴스 템플릿을 지정하면 템플릿의 리전과 동일한 리전 내에서만 미래용 예약 요청을 만들 수 있습니다.
- 전역 인스턴스 템플릿의 경우: global
INSTANCE_TEMPLATE_NAME: 기존 인스턴스 템플릿의 이름

TOTAL_COUNT: 예약하려는 VM의 총 개수
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시간 이상이어야 합니다. 또는 endTime 필드를 duration 필드로 바꿔서 예약 기간의 시작 시간으로부터 특정 기간을 지정할 수 있습니다.
```
"duration": {
  "seconds": END_DURATION
}
```
END_DURATION을 초 단위의 기간으로 바꿉니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

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

중요: 미래용 예약 요청을 만들 때 오류가 발생하지 않도록 하려면 예약 기간이 VM 속성 및 영역이 일치하고 현재 프로젝트에 생성되었거나 현재 프로젝트와 공유된 다른 기존 미래용 예약 요청의 예약 기간과 겹치지 않도록 해야 합니다. 미래용 예약 요청의 예약 기간을 개략적으로 확인하려면 미래용 예약 요청 목록을 확인하세요.

예를 들어 us-central1-a 영역에서 다음 속성을 사용하여 fr-02라는 미래용 예약 요청 초안을 만들려고 한다고 가정해 보겠습니다.

예약 기간은 2024년 11월 10일 자정(UTC)에 시작하여 2024년 12월 10일 자정(UTC)에 종료됩니다.
총 80대의 VM

us-central1 리전의 리전 인스턴스 템플릿입니다.

자동 삭제 옵션이 사용 설정되어 있습니다. 자동 생성된 예약은 예약 기간이 종료되면 삭제됩니다.

미래용 예약 요청이 project-1 및 project-2에 공유됩니다.

fr-02를 만들려면 다음과 같이 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

자동 생성된 예약의 이름 프리픽스를 지정하려면 namePrefix 필드를 포함합니다.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

예약 기간의 종료 시간이 지난 후 자동 생성된 예약을 삭제하려면 다음 방법 중 하나를 선택합니다.

예약 기간이 종료된 후 특정 시간에 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDeleteTime 필드를 지정합니다.

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

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

DELETE_TIME을 Compute Engine에서 자동 생성된 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 RFC 3339 타임스탬프 형식이어야 합니다.

예약 기간의 시작 시간에서 특정 기간이 지난 후 자동 생성된 예약을 삭제하려면 autoDeleteAutoCreatedReservations를 true로 설정하고 autoCreatedReservationsDuration 필드를 지정합니다.

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

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.

미래용 예약 요청 초안을 만든 후 Compute Engine에서 요청에 프로비저닝할 VM 수를 결정할 수 있습니다.

기존 VM 지정

VM과 동일한 프로젝트 및 영역에 있는 기존 VM을 기반으로만 미래용 예약 요청 초안을 만들 수 있습니다.

미래용 예약 요청이 Google Cloud에서 승인되고 예약 기간이 시작되면 참조 VM과 일치하는 속성이 있는 VM을 만들어 자동 생성된 예약을 사용할 수 있습니다. 다음 중 하나를 수행하여 이 작업을 수행할 수 있습니다.

다음과 같이 인스턴스 템플릿을 만들고 사용합니다.
1. 참조 VM 속성을 재정의하지 않고 참조 VM을 기반으로 인스턴스 템플릿을 만듭니다.
  
  참고: VM 프로젝트 외부에 있는 참조 VM을 기반으로 인스턴스 템플릿을 만들 수 없습니다. 예약이 공유된 프로젝트의 경우 해당 프로젝트에 유사한 인스턴스 템플릿을 만들어야 합니다.
2. 다음 중 하나 또는 둘 다 수행하여 새로 만든 템플릿으로 VM을 만듭니다.
  - 단일 VM을 만듭니다.
  - 영역 관리형 인스턴스 그룹(MIG)을 만듭니다.
다음과 같이 참조 VM과 정확하게 일치하는 속성이 있는 VM을 만듭니다.
- 소유자 프로젝트에서 만들려는 VM의 속성을 변경하지 않고 참조 VM을 기반으로 VM을 만듭니다.
- 소비자 프로젝트에서 VM 속성과 참조 VM 속성이 일치하는지 수동으로 확인하면서 VM을 만듭니다.

기존 VM의 속성을 사용하는 공유 미래용 예약 요청을 만들려면 다음 단계를 따르세요.

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

예약으로 이동
미래용 예약 탭을 클릭합니다.
미래용 예약 만들기를 클릭합니다.

미래용 예약 만들기 페이지가 열립니다.
이름에 미래용 예약 요청을 위한 이름을 입력합니다.
접두사에 이름 접두사를 입력합니다. 이 미래용 예약 요청에서 자동 생성된 각 예약의 이름은 이 접두사로 시작합니다.
리전 및 영역에 리소스를 예약할 리전과 영역을 선택합니다.
시작 시간에 예약 기간의 시작 시간을 입력합니다. 시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 잠금 시간에 들어가기 전에 미래용 예약을 수정, 취소 또는 삭제할 수 있는 충분한 시간을 확보하려면 시작 시간에 권장되는 값을 지정합니다.
종료 시간에 예약 기간의 종료 시간을 입력합니다. 예약 기간은 최소 24시간 이상이어야 합니다.

기간 요약 섹션에서 예약 기간의 길이를 확인할 수 있습니다. 검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.
공유 유형 섹션에서 다음을 수행합니다.
1. 공유 미래용 예약 요청을 지정하려면 공유를 선택합니다.
2. 프로젝트 추가를 클릭하고 미래용 예약 요청을 공유하려는 현재 프로젝트의 조직에서 프로젝트를 선택합니다. 프로젝트는 최대 100개까지 선택할 수 있습니다.
VM 인스턴스 수에 해당 기간 동안 예약하려는 VM의 총 개수, VM 구성, 미래용 예약 요청에 지정된 프로젝트를 입력합니다.

중요: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 검토를 위해 미래용 예약 요청을 제출했을 때 Google Cloud에서 요청을 거부합니다.
머신 구성 섹션에서 다음을 수행합니다.
1. 기존 VM 사용을 선택합니다.
2. 기존 VM에 예약을 만드는 데 사용할 속성이 있는 VM을 선택합니다.
자동 생성된 예약 자동 삭제 시간 섹션에서 다음 중 하나를 수행합니다.
- Compute Engine이 미래용 예약 요청을 위해 자동 생성된 예약을 자동으로 삭제하도록 하려면 다음 안내를 따르세요.
  
  주의: 자동 삭제 옵션이 사용 설정된 경우 자동 생성된 모든 예약은 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
  1. 아직 사용 설정되지 않은 경우 자동 삭제 사용 설정 전환 버튼을 클릭하여 사용 위치로 전환합니다.
  2. (선택사항) 자동 삭제 시간에 자동 생성된 예약을 삭제할 날짜와 시간을 입력합니다. 날짜와 시간은 예약 기간의 종료 시간보다 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
- 그렇지 않으면 자동 삭제 사용 설정 전환 버튼을 클릭하여 해제 위치로 전환합니다.
미래용 예약 요청 초안 만들기를 완료하려면 초안 저장을 클릭합니다.

예약 페이지가 열립니다. 미래용 예약 요청 만들기를 완료하는 데 최대 1분이 걸릴 수 있습니다.

미래용 예약 요청 초안을 만든 후 Compute Engine에서 요청에 프로비저닝할 VM 수를 결정할 수 있습니다.

속성 직접 지정

미래용 예약을 위해 프로비저닝된 자동 생성된 예약을 약정에 연결하려면 자동 삭제 옵션을 사용 중지해야 합니다. 자세한 내용은 생성 후 제한사항을 참조하세요.

속성을 직접 지정하여 공유 미래용 예약 요청을 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

예약으로 이동
미래용 예약 탭을 클릭합니다.
미래용 예약 만들기를 클릭합니다.

미래용 예약 만들기 페이지가 열립니다.
이름에 미래용 예약 요청을 위한 이름을 입력합니다.
접두사에 이름 접두사를 입력합니다. 이 미래용 예약 요청에서 자동 생성된 각 예약의 이름은 이 접두사로 시작합니다.
리전 및 영역에 리소스를 예약할 리전과 영역을 선택합니다.
시작 시간에 예약 기간의 시작 시간을 입력합니다. 시작 시간은 검토를 위해 미래용 예약 요청을 제출하는 날짜 및 시간을 기준으로 1년 이내여야 합니다. 잠금 시간에 들어가기 전에 미래용 예약을 수정, 취소 또는 삭제할 수 있는 충분한 시간을 확보하려면 시작 시간에 권장되는 값을 지정합니다.
종료 시간에 예약 기간의 종료 시간을 입력합니다. 예약 기간은 최소 24시간 이상이어야 합니다.

기간 요약 섹션에서 예약 기간의 길이를 확인할 수 있습니다. 검토를 위해 미래용 예약 요청을 제출한 후 Google Cloud에서 이를 승인할 가능성을 높이려면 예약 기간에 권장 값을 지정해야 합니다.
공유 유형 섹션에서 다음을 수행합니다.
1. 공유 미래용 예약 요청을 지정하려면 공유를 선택합니다.
2. 프로젝트 추가를 클릭하고 미래용 예약 요청을 공유하려는 현재 프로젝트의 조직에서 프로젝트를 선택합니다. 프로젝트는 최대 100개까지 선택할 수 있습니다.
VM 인스턴스 수에 해당 기간 동안 예약하려는 VM의 총 개수, VM 구성, 미래용 예약 요청에 지정된 프로젝트를 입력합니다.

중요: 예약하려는 리소스에 충분한 할당량이 있는지 확인하세요. 그렇지 않으면 검토를 위해 미래용 예약 요청을 제출했을 때 Google Cloud에서 요청을 거부합니다.
머신 구성 섹션에서 다음을 수행합니다.
1. 아직 선택하지 않았다면 머신 유형 지정을 선택합니다.
2. 예약된 VM에 사용할 머신 유형을 지정합니다.
자동 생성된 예약 자동 삭제 시간 섹션에서 다음 중 하나를 수행합니다.
- Compute Engine이 미래용 예약 요청을 위해 자동 생성된 예약을 자동으로 삭제하도록 하려면 다음 안내를 따르세요.
  
  주의: 자동 삭제 옵션이 사용 설정된 경우 자동 생성된 모든 예약은 완전히 사용되었는지 여부에 관계없이 지정된 삭제 시간에 삭제됩니다.
  1. 아직 사용 설정되지 않은 경우 자동 삭제 사용 설정 전환 버튼을 클릭하여 사용 위치로 전환합니다.
  2. (선택사항) 자동 삭제 시간에 자동 생성된 예약을 삭제할 날짜와 시간을 입력합니다. 날짜와 시간은 예약 기간의 종료 시간보다 이후여야 합니다. 이 필드를 비워 두면 예약 기간이 종료되고 2시간 이내에 자동 생성된 예약이 삭제됩니다.
- 그렇지 않으면 자동 삭제 사용 설정 전환 버튼을 클릭하여 해제 위치로 전환합니다.
미래용 예약 요청 초안 만들기를 완료하려면 초안 저장을 클릭합니다.

예약 페이지가 열립니다. 미래용 예약 요청 만들기를 완료하는 데 최대 1분이 걸릴 수 있습니다.

gcloud

속성을 직접 지정하여 공유 미래용 예약 요청을 만들려면 --share-setting=projects 및 --share-with 플래그가 있는 gcloud beta compute future-reservations create 명령어를 사용합니다.

선택적 플래그를 포함하지 않고 속성을 직접 지정하여 미래용 예약 요청 초안을 만들고 예약 기간이 끝나면 자동 생성된 예약을 자동으로 삭제하려면 다음 명령어를 실행합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

다음을 바꿉니다.

FUTURE_RESERVATION_NAME: 미래용 예약 요청의 이름
MACHINE_TYPE: 예약된 각 VM에 사용할 머신 유형

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의 총 개수
ZONE: 리소스를 예약할 영역

예를 들어 us-central1-a 영역에서 다음 속성을 사용하여 fr-02라는 미래용 예약 요청 초안을 만들려고 한다고 가정해 보겠습니다.

예약 기간은 2024년 11월 10일 자정(UTC)에 시작하여 2024년 12월 10일 자정(UTC)에 종료됩니다.
총 80대의 VM

4개의 vCPU가 있는 N2 사전 정의된 머신 유형

자동 삭제 옵션이 사용 설정되어 있습니다. 자동 생성된 예약은 예약 기간이 종료되면 삭제됩니다.

미래용 예약 요청이 project-1 및 project-2에 공유됩니다.

fr-02를 만들려면 다음 명령어를 실행합니다.

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

예약된 N1 VM에 GPU를 연결하려면 --accelerator 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

다음을 바꿉니다.

NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수
ACCELERATOR_TYPE: N1 VM에 지원되는 GPU 모델. 오류를 방지하려면 선택한 GPU 모델을 미래용 예약 요청을 만드는 영역에서 사용할 수 있는지 확인합니다.

예약 기간의 종료 시간이 지난 후 자동 생성된 예약을 삭제하려면 다음 방법 중 하나를 선택합니다.

예약 기간의 종료 시간이 지난 후 특정 날짜 및 시간에 자동 생성된 예약을 삭제하려면 --auto-created-reservations-delete-time 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

AUTO_CREATED_RESERVATIONS_DELETE_TIME을 RFC 3339 타임스탬프 형식으로 지정된 날짜 및 시간으로 바꿉니다.

예약 기간의 종료 시간이 지난 후 특정 시간에 자동 생성된 예약을 삭제하려면 --auto-created-reservations-duration 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

DURATION_BEFORE_DELETE를 일, 시간, 분 또는 초의 기간으로 바꿉니다. 예를 들어 30분에 30m을 지정하고 1일 2시간 3분 4초에 1d2h3m4s를 지정합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

예약된 각 VM에 하나 이상의 로컬 SSD 디스크를 추가하려면 하나 이상의 --local-ssd 플래그를 포함합니다. 로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다. 각 로컬 SSD 디스크는 375GB입니다.

예를 들어 미래용 예약 요청 초안을 만들 때 로컬 SSD 디스크 2개를 지정하려면 다음과 같이 --local-ssd 플래그 2개를 포함합니다.
```
gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE
```
INTERFACE_1 및 INTERFACE_2를 다음과 같이 로컬 SSD 디스크에 사용하려는 인터페이스 유형으로 바꿉니다.
- 부팅 디스크 이미지에 최적화된 NVMe 드라이버가 포함된 경우에는 NVME를 지정합니다.
- 그렇지 않은 경우 SCSI를 지정합니다.
예약된 VM에 지정되는 머신 유형이 선택된 디스크 인터페이스를 지원하는지 확인합니다. 그렇지 않으면 미래용 예약 요청을 만들 수 없습니다. 자세한 내용은 디스크 인터페이스 선택 방법을 참조하세요.

예약된 VM에 영역의 기본 CPU 플랫폼 대신 특정 최소 CPU 플랫폼이 사용되도록 하려면 --min-cpu-platform 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

MIN_CPU_PLATFORM을 최소 CPU 플랫폼으로 바꿉니다. 리소스를 예약하는 영역에서 CPU 플랫폼을 사용할 수 있는지 확인하려면 영역별 사용 가능한 CPU 플랫폼을 확인합니다.

자동 생성된 예약의 이름 프리픽스를 지정하려면 --name-prefix 플래그를 포함합니다.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

REST

속성을 직접 지정하여 공유 미래용 예약 요청을 만들려면 beta.futureReservations.insert 메서드에 POST 요청을 수행합니다.

선택적 필드를 포함하지 않고 속성을 직접 지정하여 미래용 예약 요청 초안을 만들려면 다음과 같이 POST 요청을 실행합니다.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

다음을 바꿉니다.

PROJECT_ID: 리소스를 예약하려는 프로젝트의 ID
ZONE: 리소스를 예약할 영역
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: 이 필드를 true로 설정하면 Compute Engine은 예약 기간의 종료 시간부터 2시간 이내에 이 미래용 예약에 대해 자동으로 생성된 예약을 자동으로 삭제합니다. 자동 생성된 예약을 약정에 연결하려면 이 필드를 false로 설정합니다.

CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 이 미래용 예약 요청을 공유할 수 있는 프로젝트의 프로젝트 ID입니다. 프로젝트는 최대 100개까지 지정할 수 있습니다. 이러한 프로젝트는 미래용 예약 요청이 생성된 프로젝트(소유자 프로젝트)와 동일한 조직에 있어야 합니다. 소유자 프로젝트는 지정하지 않습니다. 기본적으로 이 미래용 예약 요청에 대해 자동 생성된 예약을 사용할 수 있습니다.

TOTAL_COUNT: 예약하려는 VM의 총 개수
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시간 이상이어야 합니다. 또는 endTime 필드를 duration 필드로 바꿔서 예약 기간의 시작 시간으로부터 특정 기간을 지정할 수 있습니다.
```
"duration": {
  "seconds": END_DURATION
}
```
END_DURATION을 초 단위의 기간으로 바꿉니다. 예를 들어 1,209,600초(14일)에 1209600을 지정합니다.

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

중요: 미래용 예약 요청을 만들 때 오류가 발생하지 않도록 하려면 예약 기간이 VM 속성 및 영역이 일치하고 현재 프로젝트에 생성되었거나 현재 프로젝트와 공유된 다른 기존 미래용 예약 요청의 예약 기간과 겹치지 않도록 해야 합니다. 미래용 예약 요청의 예약 기간을 개략적으로 확인하려면 미래용 예약 요청 목록을 확인하세요.

예를 들어 us-central1-a 영역에서 다음 속성을 사용하여 fr-02라는 미래용 예약 요청 초안을 만들려고 한다고 가정해 보겠습니다.

예약 기간은 2024년 11월 10일 자정(UTC)에 시작하여 2024년 12월 10일 자정(UTC)에 종료됩니다.
총 80대의 VM

4개의 vCPU가 있는 N2 사전 정의된 머신 유형

자동 삭제 옵션이 사용 설정되어 있습니다. 자동 생성된 예약은 예약 기간이 종료되면 삭제됩니다.

미래용 예약 요청이 project-1 및 project-2에 공유됩니다.

fr-02를 만들려면 다음과 같이 POST 요청을 실행합니다.

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

선택적으로 다음 중 하나 이상을 수행할 수 있습니다.

자동 생성된 예약의 이름 프리픽스를 지정하려면 namePrefix 필드를 포함합니다.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

예약된 N1 VM에 GPU를 연결하려면 guestAccelerators 필드를 포함합니다.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

다음을 바꿉니다.

NUMBER_OF_ACCELERATORS: 예약된 VM당 추가할 GPU 수
ACCELERATOR_TYPE: N1 VM에 지원되는 GPU 모델. 오류를 방지하려면 선택한 GPU 모델을 미래용 예약 요청을 만드는 영역에서 사용할 수 있는지 확인합니다.

예약된 각 VM에 하나 이상의 로컬 SSD 디스크를 추가하려면 localSsds 필드를 포함합니다. 로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다. 각 로컬 SSD 디스크는 375GB입니다.

예를 들어 미래용 예약 요청 초안을 만들 때 로컬 SSD 디스크 2개를 지정하려면 다음과 같이 POST 요청을 실행합니다.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

INTERFACE_1 및 INTERFACE_2를 로컬 SSD 디스크에 사용하려는 인터페이스 유형으로 바꿉니다.

부팅 디스크 이미지에 최적화된 NVMe 드라이버가 포함된 경우에는 NVME를 지정합니다.
그렇지 않은 경우 SCSI를 지정합니다.

예약된 VM에 지정되는 머신 유형이 선택된 디스크 인터페이스를 지원하는지 확인합니다. 그렇지 않으면 미래용 예약 요청을 만들 수 없습니다. 자세한 내용은 디스크 인터페이스 선택 방법을 참조하세요.

예약된 VM에 영역의 기본 CPU 플랫폼 대신 특정 최소 CPU 플랫폼이 사용되도록 하려면 minCpuPlatform을 포함합니다.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

예약 기간의 종료 시간이 지난 후 자동 생성된 예약을 삭제하려면 다음 방법 중 하나를 선택합니다.

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

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

DELETE_TIME을 Compute Engine에서 자동 생성된 예약을 삭제하는 날짜 및 시간으로 바꿉니다. 날짜 및 시간은 RFC 3339 타임스탬프 형식이어야 합니다.

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

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

DURATION_BEFORE_DELETE를 초 단위의 기간으로 바꿉니다. 예를 들어 604800으로 604,800초(7일)를 지정합니다.

미래용 예약 요청 초안을 만든 후 Compute Engine에서 요청에 프로비저닝할 VM 수를 결정할 수 있습니다.

초안 요청 제출

미래용 예약 요청을 제출하고 Google Cloud에서 승인하고 잠금 시간이 지난 후에는, 미래용 예약의 예약 기간이 종료된 후에만 미래용 예약 및 자동 생성된 예약을 삭제할 수 있습니다. 동일한 속성으로 다른 미래용 예약을 만들어야 하는 경우 기존 미래용 예약을 삭제하는 것이 유용합니다. 따라서 미래용 예약 요청을 만들기 전에 다음 사항을 확인하세요.

프로젝트의 기존 예약 또는 미래용 예약은 생성할 수 있는 미래용 예약 요청의 공유 설정을 제한합니다. 미래용 예약 요청을 성공적으로 만들 수 있고 요청으로 인해 미래용 예약 요청을 공유하는 다른 프로젝트에서 문제가 발생하지 않도록 하려면 제한사항을 참조하세요.
자동 생성된 예약이 사용되는지 여부에 관계없이 전체 예약 기간 동안 Compute Engine이 프로비저닝하는 예약된 리소스에 대해 비용을 지불해야 합니다. 자세한 내용은 결제를 참고하세요.

검토를 위해 미래용 예약 요청 초안을 제출할 때 하나 이상의 속성을 수정하려면 미래용 예약 요청 수정을 참조하세요.

검토를 위해 Google Cloud에 미래용 예약 요청 초안을 제출하려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

예약으로 이동
미래용 예약 탭을 클릭합니다.
이름 열에서 조달 상태가 초안인 미래용 예약 요청의 이름을 클릭합니다.

미래용 예약 요청에 대한 세부정보가 포함된 미래용 예약 페이지가 열립니다.
초안 수정을 클릭합니다.

미래용 예약 요청 초안을 업데이트하는 페이지가 열립니다.
검토를 위해 미래용 예약 요청 초안을 제출하려면 제출을 클릭합니다.

예약 페이지가 열립니다. 방금 제출한 미래용 예약 요청의 상태 열에서 조달 상태가 승인 대기 중으로 설정됩니다.

gcloud

검토를 위해 미래용 예약 요청 초안을 제출하려면 하여 --planning-status 플래그가 SUBMITTED로 설정된 gcloud beta compute future-reservations update 명령어를 사용합니다.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

다음을 바꿉니다.

FUTURE_RESERVATION_NAME: 기존 미래용 예약 요청 초안의 이름
ZONE: 미래용 예약 요청이 있는 영역

REST

검토를 위해 미래용 예약 요청 초안을 제출하려면 beta.futureReservations.update 메서드에 PATCH 요청을 실행합니다. 요청 본문에 planningStatus 필드를 포함하고 SUBMITTED로 설정합니다.

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

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

다음을 바꿉니다.

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

검토를 위해 미래용 예약 요청 초안을 제출한 후에는 다음을 수행할 수 있습니다.

요청의 조달 상태를 모니터링하고 Google Cloud에서 요청을 승인했는지 또는 거부했는지 확인하려면 미래용 예약 요청 세부정보를 확인하세요.
Google Cloud의 요청 검토를 중지하고 Compute Engine이 요청된 용량을 프로비저닝하지 못하도록 하려면 미래용 예약 요청을 취소 또는 삭제하세요.

문제 해결

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

문제 해결 후에도 계속 문제가 발생하면 기술계정 관리자 또는 영업팀에 문의하세요.

다음 단계

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

공유 미래용 예약 요청 만들기

시작하기 전에

Console

gcloud

REST

필요한 역할

필수 권한

제한사항

초안 요청 만들기

인스턴스 템플릿 지정

콘솔

gcloud

REST

기존 VM 지정

속성 직접 지정

콘솔

gcloud

REST

초안 요청 제출

콘솔

gcloud

REST

문제 해결

다음 단계