예약과 약정 사용 할인 조합

약정 사용 할인(CUD)은 1년 또는 3년 약정 사용 계약(약정)을 대가로 Compute Engine 리소스에 대해 대폭 할인된 가격을 제공합니다. 최소 리소스 사용 금액 또는 최소 지출 금액을 약속하고 그 대가로 리소스 사용 비용에 대한 CUD를 받습니다. 하지만 약정에 따라 약정 리소스에 대한 영역별 용량이 예약되지는 않습니다. 할인된 가격으로 영역별 리소스를 구입하고 용량 예약을 보장하기 위해서는 이러한 영역별 리소스에 대해 약정을 구매하고 예약을 만들어야 합니다.

이 문서에서는 예약된 리소스에 대해 CUD를 받는 방법과 리소스 기반 약정에 예약을 연결하는 방법을 설명합니다.

시작하기 전에

요구사항 및 제한사항과 함께 예약 기본사항을 검토합니다. 자세한 내용은 Compute Engine 영역별 리소스 예약을 참조하세요.
아직 인증을 설정하지 않았다면 설정합니다. 인증은 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.

예약된 리소스의 CUD

프로젝트의 모든 적격한 리소스 사용에 대해 활성 약정으로부터 CUD를 받습니다. 또한 이 프로젝트 내의 리소스 용량 예약에 대해 우려가 있는 경우 활성 약정의 CUD를 이러한 예약된 리소스에도 적용할 수 있습니다. 예약 리소스로 CUD 자격을 얻기 위해서는 다음 요구사항이 적용됩니다.

리소스 사용에 대해 어떠한 형태로든 할인을 받지 않아야 합니다.
약정이 활성화된 동안 VM이 예약을 소비해야 합니다.
최소한 활성 약정과 VM에 소비되는 예약 사이에 다음 속성이 일치해야 합니다.
- 적용되는 프로젝트 및 리전
- 머신 계열 시리즈

리소스 유형에 따라 다음 방법 중 하나로 예약 리소스에 대해 CUD를 받을 수 있습니다.

vCPU 및 메모리: 리소스 유형 중 하나 또는 모두에 대해 CUD를 받으려면 필요한 리소스 유형을 포함하는 리소스 기반 또는 지출 기반 약정을 구입하면 됩니다. 프로젝트의 VM에 해당 속성이 활성 약정과 일치하는 예약이 소비되는 경우 이러한 유형의 예약 리소스에 대해 적용 가능한 CUD가 자동으로 제공됩니다. 약정보다 많은 리소스를 예약한 경우에는 이러한 추가 리소스에 대해 CUD가 제공되지 않습니다.
GPU 및 로컬 SSD 디스크: 이러한 리소스 유형 중 하나 또는 모두에 대해 CUD를 받으려면 다음을 수행해야 합니다.
- 필요한 리소스 유형이 포함된 리소스 기반 약정을 구입합니다.
- 속성이 약정과 일치하는 모든 약정 리소스에 대해 예약을 만들고 이러한 예약을 약정에 연결합니다.
프로젝트의 VM에 이러한 연결된 예약이 소비되면 이러한 유형의 예약 리소스에 대해 적용 가능한 CUD가 제공됩니다.

리소스 기반 약정에 예약 연결

리소스 기반 약정에 예약을 연결하고 사용하려는 약정 리소스에 대해 특정 영역에 용량이 예약되어 있도록 보장할 수 있습니다. 단일 약정에 여러 예약을 연결할 수 있지만, 각 예약을 단일 약정에만 연결할 수 있습니다. 약정을 구매할 때 다음 방법 중 하나로 약정에 예약을 연결할 수 있습니다.

속성이 약정과 일치하는 기존 예약 사용
약정을 구매하는 동안 새로운 일치하는 예약 만들기

예약이 연결된 약정을 구매한 후에는 약정이 활성 상태로 있는 한 예약이 활성 상태로 유지됩니다. 약정이 만료되면 Compute Engine이 연결된 예약을 자동으로 삭제합니다. 이러한 예약을 삭제해도 해당 예약을 소비 중인 실행 중인 VM에 아무런 영향을 주지 않습니다. 실행 중인 VM은 계속 실행되며 VM에 대한 요금은 계속 청구됩니다.

연결된 예약이 필요하지 않은 약정 리소스

약정 vCPU 및 메모리의 경우 해당 약정에 일치하는 예약을 연결할 필요가 없습니다. 그렇더라도 vCPU나 메모리 또는 둘 다 포함된 약정을 구매할 때에도 이러한 리소스를 지정하는 예약을 연결하도록 선택할 수 있습니다. 예약을 연결하지 않고 vCPU나 메모리 또는 둘 다에 대해 약정을 구매하는 방법은 연결된 예약 없이 약정 구매를 참조하세요.

연결된 예약이 필요한 약정된 리소스

약정 GPU 및 로컬 SSD 디스크의 경우 약정에 일치하는 예약을 연결해야 합니다. 또한 GPU나 로컬 SSD 디스크 또는 둘 다 포함된 약정을 구매할 때는 이러한 리소스를 예약하고 예약을 약정에 연결해야 합니다. 단일 예약 또는 예약 조합을 사용하여 이를 수행할 수 있습니다. 또한 이러한 약정을 구매할 때 vCPU나 메모리 또는 둘 다 포함할 수 있습니다. 하지만 이러한 vCPU 또는 메모리를 예약할 필요는 없습니다. GPU나 로컬 SSD 디스크 또는 둘 다 포함된 약정을 구매하는 방법은 이 문서에서 연결된 예약이 있는 약정 구매를 참조하세요.

GPU 및 로컬 SSD 디스크에 대해 CUD를 지원하는 머신 시리즈의 전체 목록은 리소스 기반 CUD 문서의 약정 유형 섹션을 참조하세요.

연결된 예약에 허용되는 리소스 수량

vCPU 및 메모리의 경우 약정보다 많거나 적은 리소스를 지정하는 예약을 연결할 수 있습니다. 예약한 것보다 많은 vCPU 또는 메모리를 약정할 경우 Compute Engine이 이러한 예약된 리소스에 대해서만 용량을 예약합니다. 하지만 리전에서 가용성에 따라 추가 약정 리소스를 계속 사용할 수 있습니다. 약정보다 많은 vCPU 또는 메모리를 예약할 경우 예약하는 추가 리소스에 대해 CUD가 제공되지 않습니다.

예를 들어 vCPU 4개 및 30GB 메모리 약정을 구매할 때 다음 중 하나를 수행하도록 선택할 수 있습니다.

예약을 전혀 연결하지 않습니다.
해당 리소스 유형의 조합을 지정하는 예약을 연결합니다. 예를 들면 다음과 같습니다.
- vCPU 4개 및 30GB 메모리
- vCPU 2개 및 50GB 메모리
- vCPU 10개 및 10GB 메모리

하지만 약정에 GPU나 로컬 SSD 디스크 또는 둘 다 포함된 경우 이러한 리소스를 모두 예약하고 연결해야 합니다. 연결된 예약에는 약정 대상 GPU 및 로컬 SSD 디스크와 정확히 동일한 개수와 유형을 지정해야 합니다. 따라서 연결된 예약에서 GPU 또는 로컬 SSD 디스크에 대해 추가 개수 또는 유형을 지정할 수 없습니다. 예를 들어 30GB 메모리 및 NVIDIA P100 GPU 4개의 약정을 구매한다고 가정해 보세요. 연결된 예약(또는 연결된 예약의 조합)에서 vCPU 또는 메모리를 제한 없이 지정할 수 있지만 NVIDIA P100 유형의 GPU가 정확히 4개 있어야 합니다. 이 예시에서는 다음 리소스 조합을 지정하는 예약을 연결할 수 없습니다.

NVIDIA P100 GPU 6개
NVIDIA P100 GPU 2개
NVIDIA P100 GPU 4개 및 NVIDIA V100 GPU 2개
NVIDIA P100 GPU 4개 및 로컬 SSD 디스크 4개

연결된 예약이 있는 약정 구매

새 약정을 구매할 때 다음 방법 중 하나로 약정에 예약을 연결할 수 있습니다.

속성이 약정과 일치하는 기존 예약 사용
약정을 구매하는 동안 새로운 일치하는 예약 만들기

약정을 구매하면 미국 및 캐나다 태평양 표준시(UTC-8 또는 일광 절약 시간 중에는 UTC-7) 기준 다음 날 오전 12시에 약정이 활성화됩니다. 약정 구매 시점부터 활성화 전까지는 약정 상태가 NOT_YET_ACTIVE(또는 Google Cloud 콘솔의 PENDING)로 유지됩니다. 활성화되면 약정 상태는 ACTIVE로 변경됩니다. 예를 들어 미국 및 캐나다 태평양 표준시(UTC-8 또는 UTC-7) 기준 1월 20일 오후 10시에 약정을 구매한다고 가정해 보겠습니다. Compute Engine에서 상태가 NOT_YET_ACTIVE인 약정을 즉시 만듭니다. 하지만 약정은 미국 및 캐나다 태평양 표준시(UTC-8 또는 UTC-7) 기준 1월 21일 오전 12시에만 ACTIVE가 됩니다.

요구사항

연결된 예약이 있는 약정을 구매하려면 먼저 이러한 요구사항을 검토하고 약정 및 예약이 다음 조건을 충족하는지 확인합니다.

약정을 구매하고 동일한 프로젝트 및 리전에서 연결된 예약을 만들어야 합니다.
약정을 구매하고 동일한 머신 계열 시리즈의 리소스에 대해 연결된 예약을 만들어야 합니다.
연결된 예약에서 자동 삭제 옵션을 사용 중지해야 합니다.
약정에 GPU가 포함된 경우 예약에 지정된 GPU 유형과 약정이 일치해야 합니다.
GPU와 로컬 SSD 디스크의 경우 각 리소스 유형의 예약된 리소스 수가 해당 리소스 유형에 약정된 리소스 수와 정확히 일치해야 합니다. 예를 들어 V100 GPU 4개의 약정을 구매하려면 약정의 연결된 예약에 V100 GPU 총 4개를 지정해야 합니다. 하지만 예약하는 vCPU 및 메모리의 크기는 약정하는 크기보다 크거나 작을 수 있습니다.
GPU의 경우 사용할 특정 GPU 유형의 약정을 구매합니다. 예를 들어 NVIDIA P100 또는 NVIDIA V100의 약정을 구매할 수 있지만 NVIDIA P100 GPU용으로 구매한 약정을 사용하여 NVIDIA V100 GPU를 적용할 수는 없습니다.
연결된 예약이 공유 예약이고 약정 프로젝트 외부에서 해당 예약을 소비할 때 적용 가능한 CUD를 받으려면 다음 작업을 모두 수행해야 합니다.
- 약정과 동일한 Cloud Billing 계정에 속하는 프로젝트 사이에만 예약을 공유합니다.
- 해당 Cloud Billing 계정에 대해 CUD 공유를 사용 설정합니다.

기존 예약 연결

Google Cloud 콘솔, Google Cloud CLI, REST를 사용해서 약정을 구매하는 동안 기존 예약을 연결할 수 있습니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한이 있어야 합니다.

약정 만들기: 프로젝트에 대한 compute.commitments.create 권한
예약 만들기: 프로젝트에 대한 compute.reservations.create 권한

콘솔

Google Cloud 콘솔을 사용하여 약정을 구매하기 전에 약정을 구매하는 데 사용할 프로젝트를 선택합니다. Cloud Billing 계정에 CUD 공유가 사용 설정된 경우 해당 Cloud Billing 계정의 프로젝트를 사용하여 약정을 구매할 수 있습니다. 프로젝트를 선택한 후 다음을 수행합니다.

Google Cloud 콘솔에서 약정 사용 할인 페이지로 이동합니다.

약정 사용 할인으로 이동
새 약정을 구매하려면 약정 구매를 클릭합니다. 약정 사용 할인 구매 페이지가 열리고 하드웨어 탭이 표시됩니다.
이름 필드에 약정의 이름을 입력합니다.
리전 필드에서 Compute Engine 리소스를 약정할 리전을 선택합니다.
약정 유형 필드에서 약정된 리소스의 머신 계열 시리즈를 선택합니다. 다음 약정 유형은 GPU, 로컬 SSD 디스크 또는 둘 다를 위한 옵션을 제공합니다.
- A2 머신 유형 리소스의 경우 가속기 최적화 A2
- A3 High 머신 유형 리소스의 경우 가속기 최적화 A3
- A3 Mega 머신 유형 리소스의 경우 가속기 최적화 A3 Mega
- C2 머신 유형 리소스의 경우 컴퓨팅 최적화 C2
- C2D 머신 유형 리소스의 경우 컴퓨팅 최적화 C2D
- C3 머신 유형 리소스의 경우 범용 C3
- C3D 머신 유형 리소스의 경우 범용 C3D
- N1 머신 유형 리소스의 경우 범용 N1
- N2 머신 유형 리소스의 경우 범용 N2
- N2D 머신 리소스의 경우 범용 N2D
- G2 머신 유형 리소스의 경우 그래픽 최적화 G2
- M3 머신 유형 리소스의 경우 메모리 최적화 M3
- Z3 머신 유형 리소스의 경우 스토리지 최적화 Z3
기간 필드에서 약정 기간을 선택합니다.
코어 필드에 커밋할 vCPU 수를 입력합니다.
메모리 필드에 약정할 메모리 양(GB)을 입력합니다.
GPU에 커밋하려면 GPU 섹션에서 GPU 추가를 클릭한 후 다음을 수행합니다.
1. GPU 유형 필드에서 GPU 유형을 선택합니다.
2. GPU 수 필드에 GPU 수를 입력합니다.
3. 선택사항: GPU 모델에서 그래프 워크로드에 대한 NVIDIA RTX 가상 워크스테이션(vWS)을 지원하고 그래픽 집중 워크로드를 실행하려는 경우 가상 워크스테이션 사용(NVIDIA GRID) 체크박스를 선택합니다.
로컬 SSD 디스크에 약정하려면 로컬 SSD 섹션에서 SSD 추가를 클릭한 후 SSD 수 필드에서 디스크 수를 지정합니다.
하나 이상의 기존 예약을 약정에 연결하려면 예약 필드에서 기존 예약 연결을 선택합니다.

Google Cloud 콘솔에 리전, 머신 유형, GPU 유형이 약정과 일치하는 프로젝트의 모든 예약 목록이 표시됩니다. 그런 후 다음 작업을 수행합니다.
1. 선택사항. 특정 속성이 있는 예약을 보려면 필터 메뉴에서 원하는 속성에 필터를 추가하거나 삭제합니다.
2. 약정에 연결할 예약을 모두 선택합니다.
중요: 연결된 모든 예약에 지정된 GPU 및 로컬 SSD 디스크의 유형과 총 개수는 약정에서 지정한 것과 일치해야 합니다. 그렇지 않으면 약정을 구매할 수 없습니다.
연결된 예약이 있는 약정 구매를 완료하려면 다음을 수행합니다.
1. 구매를 클릭합니다.
2. 약정 사용 할인 구매 대화상자에서 서비스별 약관에 동의하는 경우 구매를 다시 클릭합니다.

gcloud

기존 예약을 연결하여 약정을 구매하려면 gcloud compute commitments create 명령어를 실행합니다. 명령어에 --existing-reservation 플래그를 포함하여 약정에 연결하려는 기존 예약을 지정합니다. 연결하려는 기존 예약에 대해 이 플래그의 새 인스턴스를 포함합니다. 약정에 기존 예약을 원하는 만큼 연결할 수 있습니다.

예를 들어 2개의 예약을 연결하여 약정을 구매하려면 다음 명령어를 실행합니다.

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

다음을 바꿉니다.

COMMITMENT_NAME: 약정의 이름입니다.
REGION: 약정이 있는 리전입니다.
PROJECT_ID: 연결된 예약이 있는 약정을 구매하려는 프로젝트의 ID입니다.
DURATION: 약정 기간입니다(12-month 또는 36-month).
COMMITMENT_TYPE: 약정 유형입니다. 다음 약정 유형은 GPU, 로컬 SSD 디스크 또는 둘 다를 위한 옵션을 제공합니다.
- A2 머신 유형 리소스의 경우 accelerator-optimized
- A3 High 머신 유형 리소스의 경우 accelerator-optimized-a3
- A3 Mega 머신 유형 리소스의 경우 accelerator-optimized-a3-mega
- C2 머신 유형 리소스의 경우 compute-optimized
- C2D 머신 유형 리소스의 경우 compute-optimized-c2d
- C3 머신 유형 리소스의 경우 compute-optimized-c3
- C3D 머신 유형 리소스의 경우 compute-optimized-c3d
- N1 머신 유형 리소스의 경우 general-purpose
- N2 머신 유형 리소스의 경우 general-purpose-n2
- N2D 머신 리소스의 경우 general-purpose-n2d
- G2 머신 유형 리소스의 경우 graphics-optimized
- M3 머신 유형 리소스의 경우 memory-optimized-m3
- Z3 머신 유형 리소스의 경우 storage-optimized-z3
COMMITTED_VCPUS: 약정에 포함할 vCPU 수입니다. 값은 양의 정수여야 합니다.
COMMITTED_MEMORY: 약정에 포함하려는 메모리 크기(MB 또는 GB)입니다. 예를 들면 10240MB 또는 10GB입니다. 단위를 지정하지 않으면 Compute Engine에서 GB가 단위로 사용됩니다. 메모리는 0.25GB 단위로 구매할 수 있습니다.
COMMITTED_LOCAL_SSD: 약정에 포함하려는 로컬 SSD 공간의 크기(GB)입니다. 각 로컬 SSD 디스크는 375GB입니다.
COMMITTED_ACCELERATOR_COUNT: 약정에 포함할 GPU 수입니다.
COMMITTED_ACCELERATOR_TYPE: 약정에 포함할 GPU 유형입니다.
RESERVATION_NAME_1 및 RESERVATION_NAME_2: 약정에 연결하려는 기존 예약의 이름입니다.
RESERVATION_ZONE_1 및 RESERVATION_ZONE_2: 약정에 연결하려는 기존 예약의 영역입니다.

예시: 기존 예약을 연결하여 약정 구매

myproject 프로젝트의 us-central1-a 및 us-central1-b 영역에 res-01 및 res-02의 2개 예약이 있다고 가정해 보세요. 이러한 예약에는 NVIDIA P100 GPU 4개 및 로컬 SSD 디스크 4개가 조합된 용량이 포함됩니다. 이러한 GPU 및 로컬 SSD 디스크에 대해 이 프로젝트의 us-central1 리전에서 새 약정을 구매하고 이러한 기존 예약을 연결된 예약으로 사용하려면 다음 명령어를 실행합니다. 예시 약정에는 vCPU와 메모리도 포함됩니다.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b

REST

기존 예약을 연결하여 약정을 구매하려면 regionCommitments.insert 메서드에 대해 POST 요청을 수행합니다. 요청에 existingReservations 필드를 포함하여 약정에 연결하려는 모든 기존 예약의 쉼표로 구분된 목록을 지정합니다. 약정에 기존 예약을 원하는 만큼 연결할 수 있습니다.

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

{
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations": "RESERVATION_URLs"
}

다음을 바꿉니다.

COMMITMENT_NAME: 약정의 이름입니다.
REGION: 약정이 있는 리전입니다.
PROJECT_ID: 연결된 예약이 있는 약정을 구매하려는 프로젝트의 ID입니다.
DURATION: 약정 기간입니다(TWELVE_MONTH 또는 THIRTY_SIX_MONTH).
COMMITMENT_TYPE: 약정 유형입니다. 다음 약정 유형은 GPU, 로컬 SSD 디스크 또는 둘 다를 위한 옵션을 제공합니다.
- A2 머신 유형 리소스의 경우 ACCELERATOR_OPTIMIZED
- A3 High 머신 유형 리소스의 경우 ACCELERATOR_OPTIMIZED_A3
- A3 Mega 머신 유형 리소스의 경우 ACCELERATOR_OPTIMIZED_A3_MEGA
- C2 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED
- C2D 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C2D
- C3 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C3
- C3D 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C3D
- N1 머신 유형 리소스의 경우 GENERAL_PURPOSE
- N2 머신 유형 리소스의 경우 GENERAL_PURPOSE_N2
- N2D 머신 리소스의 경우 GENERAL_PURPOSE_N2D
- G2 머신 유형 리소스의 경우 GRAPHICS_OPTIMIZED
- M3 머신 유형 리소스의 경우 MEMORY_OPTIMIZED_M3
- Z3 머신 유형 리소스의 경우 STORAGE_OPTIMIZED_Z3
COMMITTED_VCPUS: 약정에 포함할 vCPU 수입니다. 값은 양의 정수여야 합니다.
COMMITTED_MEMORY: 약정에 포함하려는 메모리의 크기(MB)입니다. 예를 들면 10240MB입니다. 메모리는 256MB 단위로 구매할 수 있습니다.
COMMITTED_LOCAL_SSD: 약정에 포함하려는 로컬 SSD 스토리지의 크기(GB)입니다. 각 로컬 SSD 디스크는 375GB입니다.
COMMITTED_ACCELERATOR_COUNT: 약정에 포함할 GPU 수입니다.
COMMITTED_ACCELERATOR_TYPE: 약정에 포함할 GPU 유형입니다.

RESERVATION_URLs: 약정에 연결하려는 기존 예약의 쉼표로 구분된 URL 목록입니다. 예를 들어 res-1 및 res-2라는 2개의 예약을 연결하려면 다음을 지정합니다.

"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"

예시: 기존 예약을 연결하여 약정 구매

myproject 프로젝트의 us-central1-a 및 us-central1-b 영역에 res-01 및 res-02의 2개 예약이 있다고 가정해 보세요. 이러한 예약에는 NVIDIA P100 GPU 4개 및 로컬 SSD 디스크 4개가 조합된 용량이 포함됩니다. 이러한 GPU 및 로컬 SSD 디스크에 대해 이 프로젝트의 us-central1 리전에서 새 약정을 구매하고 이러한 기존 예약을 연결된 예약으로 사용하려면 다음 POST 요청을 수행합니다. 예시 약정에는 vCPU와 메모리도 포함됩니다.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1536000",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-b/reservations/res-02"
  ]
}

연결할 새 예약 만들기

Google Cloud 콘솔, Google Cloud CLI, REST를 사용해서 약정을 구매하는 동안 연결된 예약을 만들 수 있습니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한이 있어야 합니다.

약정 만들기: 프로젝트에 대한 compute.commitments.create 권한
예약 만들기: 프로젝트에 대한 compute.reservations.create 권한

콘솔

Google Cloud 콘솔에서 약정 사용 할인 페이지로 이동합니다.

약정 사용 할인으로 이동
새 약정을 구매하려면 약정 구매를 클릭합니다. 약정 사용 할인 구매 페이지가 열리고 하드웨어 탭이 표시됩니다.
이름 필드에 약정의 이름을 입력합니다.
리전 필드에서 Compute Engine 리소스를 약정할 리전을 선택합니다.
약정 유형 필드에서 약정된 리소스의 머신 계열 시리즈를 선택합니다. 다음 약정 유형은 GPU, 로컬 SSD 디스크 또는 둘 다를 위한 옵션을 제공합니다.
- A2 머신 유형 리소스의 경우 가속기 최적화 A2
- A3 High 머신 유형 리소스의 경우 가속기 최적화 A3
- A3 Mega 머신 유형 리소스의 경우 가속기 최적화 A3 Mega
- C2 머신 유형 리소스의 경우 컴퓨팅 최적화 C2
- C2D 머신 유형 리소스의 경우 컴퓨팅 최적화 C2D
- C3 머신 유형 리소스의 경우 범용 C3
- C3D 머신 유형 리소스의 경우 범용 C3D
- N1 머신 유형 리소스의 경우 범용 N1
- N2 머신 유형 리소스의 경우 범용 N2
- N2D 머신 리소스의 경우 범용 N2D
- G2 머신 유형 리소스의 경우 그래픽 최적화 G2
- M3 머신 유형 리소스의 경우 메모리 최적화 M3
- Z3 머신 유형 리소스의 경우 스토리지 최적화 Z3
기간에서 약정 기간으로 1년 또는 3년을 선택합니다.
코어 필드에 커밋할 vCPU 수를 입력합니다.
메모리 필드에 약정할 메모리 양(GB)을 입력합니다.
GPU에 커밋하려면 GPU 섹션에서 GPU 추가를 클릭한 후 다음을 수행합니다.
1. GPU 유형 필드에서 GPU 유형을 선택합니다.
2. GPU 수 필드에 GPU 수를 입력합니다.
3. 선택사항: GPU 모델에서 그래프 워크로드에 대한 NVIDIA RTX 가상 워크스테이션(vWS)을 지원하고 그래픽 집중 워크로드를 실행하려는 경우 가상 워크스테이션 사용(NVIDIA GRID) 체크박스를 선택합니다.
로컬 SSD 디스크에 약정하려면 로컬 SSD 섹션에서 SSD 추가를 클릭한 후 SSD 수 필드에서 디스크 수를 지정합니다.
새 예약을 만들고 약정에 연결하려면 예약 필드에서 예약 만들기를 선택한 후 다음을 수행합니다. 만들고 연결하려는 모든 새 예약에 대해 이 단계를 반복합니다.
1. 예약 추가를 클릭합니다. 새 예약 섹션이 표시됩니다.
2. 이름 필드에 연결된 예약의 이름을 입력합니다.
3. 리전 필드에서 약정과 동일한 리전을 선택합니다.
4. 영역 필드에서 리소스를 예약할 영역을 선택합니다.
5. 공유 유형 섹션에서 다음 방법 중 하나로 이 예약을 공유할 방법을 지정합니다.
  - 단일 프로젝트 예약을 만들려면 로컬을 선택합니다.
  - 여러 프로젝트와 공유되는 예약을 만들려면 공유를 선택합니다. 그 다음 이 예약을 공유할 프로젝트를 지정하려면 프로젝트 추가를 클릭한 후 현재 프로젝트의 조직에서 원하는 프로젝트를 선택합니다.
6. VM 인스턴스와 함께 사용 필드에서 다음 방법 중 하나로 VM이 예약을 사용하는 방식을 선택합니다.
  - 속성이 일치하는 VM이 이 예약을 자동으로 사용하도록 허용하려면 예약 자동 사용(기본값)을 클릭합니다.
  - 이름을 통해 이 예약을 명시적으로 타겟팅하는 일치하는 속성을 가진 VM을 만들 때만 이 예약의 리소스를 소비하려면 특정 예약 선택을 선택합니다.
7. 리소스 세부정보 섹션에서 다음을 수행합니다.
  1. VM 인스턴스 수 필드에 예약할 VM 인스턴스 수를 입력합니다.
  2. 머신 구성 섹션에서 다음 방법 중 하나로 예약된 VM의 속성을 지정합니다.
    1. 기존 인스턴스 템플릿을 사용하여 VM의 속성을 지정하려면 인스턴스 템플릿 사용을 선택합니다.
      
      인스턴스 템플릿 필드에서 약정과 동일한 머신 계열 시리즈를 지정하는 인스턴스 템플릿을 선택합니다. 리전 인스턴스 템플릿을 선택하는 경우 해당 인스턴스 템플릿의 리전도 약정에 지정된 리전과 일치해야 합니다.
    2. VM의 속성을 수동으로 지정하려면 머신 유형 선택을 선택한 후 다음을 수행합니다.
      1. 약정에 지정한 머신 시리즈에 적용되는 머신 계열을 선택합니다.
        
        범용 머신 시리즈의 경우 범용
        
        컴퓨팅 최적화 머신 시리즈에 경우 컴퓨팅 최적화
        
        메모리 최적화 머신 시리즈의 경우 메모리 최적화
        
        가속기 최적화 머신 시리즈의 경우 GPU
      2. 시리즈 열이 있는 테이블에서 커밋에 지정한 것과 동일한 머신 시리즈를 선택합니다.
      3. 머신 유형 필드에서 다음 방법 중 하나로 사전 정의된 머신 유형이나 커스텀 머신 유형을 지정합니다.
        
        사전 정의된 머신 유형을 선택하려면 사전 설정을 선택한 다음 원하는 머신 유형을 선택합니다.
        
        커스텀 머신 유형을 선택하려면 커스텀을 선택한 후 원하는 코어 및 메모리를 지정합니다.
      4. 최소 CPU 플랫폼, GPU 또는 둘 다 지정하려면 CPU 플랫폼 및 GPU 메뉴를 펼치고 다음을 수행합니다.
        
        선택사항: 최소 CPU 플랫폼을 지정하려면 CPU 플랫폼 목록에서 옵션을 선택합니다.
        
        선택사항: GPU를 예약하려면 GPU 추가를 클릭합니다. 그런 다음 GPU 유형 필드와 GPU 수 필드에서 각 VM의 GPU 유형과 수를 선택합니다.
        
        중요: 연결된 모든 예약에 지정된 GPU 유형 및 총 개수는 약정에서 지정한 것과 일치해야 합니다. 그렇지 않으면 약정을 구매할 수 없습니다.
      5. 로컬 SSD 디스크를 예약하려면 다음을 수행합니다.
        
        디스크 수 필드에서 각 VM에 적용할 로컬 SSD 디스크 수를 선택합니다.
        
        인터페이스 유형 필드에서 로컬 SSD 디스크의 인터페이스를 선택합니다.
        
        중요: 연결된 모든 예약에 지정된 총 로컬 SSD 디스크 수는 약정에서 지정한 수와 일치해야 합니다. 그렇지 않으면 약정을 구매할 수 없습니다.
8. 이 예약의 속성 지정을 완료하려면 완료를 클릭합니다.
연결된 예약이 있는 약정 구매를 완료하려면 다음을 수행합니다.
1. 구매를 클릭합니다.
2. 약정 사용 할인 구매 대화상자에서 서비스별 약관에 동의하는 경우 구매를 다시 클릭합니다.

gcloud

약정을 구매하는 동안 연결된 예약을 만들려면 gcloud compute commitments create 명령어를 실행합니다.

단일 예약 또는 다중 예약을 연결할지 여부에 따라 다음 방법 중 하나로 명령어를 실행합니다.

단일 예약을 만들고 약정에 연결하려면 다음 명령어를 실행하여 연결된 예약의 속성을 정의합니다.

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan DURATION \
    --type COMMITMENT_TYPE
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --reservation=RESERVATION_NAME \
    --reservation-zone=RESERVATION_ZONE \
    --machine-type=RESERVED_MACHINE_TYPE \
    --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
    --vm-count=NUMBER_OF_RESERVED_VMs \
    --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
    --local-ssd=interface=INTERFACE_1,size=375 \
    --local-ssd=interface=INTERFACE_2,size=375 \
    --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2

다중 예약을 만들고 약정에 연결하려면 YAML 파일을 사용해서 예약 속성을 정의한 후 약정 구매를 위해 사용하는 명령어에 이 YAML 파일을 지정합니다. 또한 선택적으로 이 YAML 파일 방법을 사용해서 단일 예약을 만들고 약정에 연결할 수도 있습니다. 이 방법을 사용해서 연결된 예약을 만들려면 다음을 수행합니다.

현재 디렉터리에 YAML 파일을 만들고 연결된 각 예약에 대해 원하는 구성을 지정합니다. 예를 들어 GPU, 2개의 로컬 SSD 디스크, 최소 CPU 플랫폼을 지정하는 2개의 프로젝트와 공유된 공유 예약 구성을 지정하려면 YAML 파일에 다음 텍스트를 포함합니다.

- reservation: RESERVATION_NAME
  reservation_zone: RESERVATION_ZONE
  require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
  vm_count: NUMBER_OF_RESERVED_VMs
  machine_type: RESERVED_MACHINE_TYPE
  accelerator:
  - count: RESERVED_ACCELERATOR_COUNT
    type: RESERVED_ACCELERATOR_TYPE
  localssd:
  - interface: INTERFACE_1
    size: 375
  - interface: INTERFACE_2
    size: 375
  project: OWNER_PROJECT_ID
  minimum-cpu-platform: MINIMUM_CPU_PLATFORM
  share-setting: SHARE_SETTING
  share-with:
  - CONSUMER_PROJECT_ID_1
  - CONSUMER_PROJECT_ID_2

다중 예약 구성을 지정하려면 만들려는 각 예약에 대해 해당 속성을 반복합니다. 기존 예약을 원하는 만큼 약정에 연결할 수 있습니다.

gcloud compute commitments create 명령어를 실행하고 --reservation-from-file 플래그를 포함합니다.

gcloud compute commitments create COMMITMENT_NAME \
    --region REGION \
    --project PROJECT_ID \
    --plan DURATION \
    --type COMMITMENT_TYPE \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --reservations-from-file=YAML_FILE

다음을 약정 및 연결된 예약의 해당 속성으로 바꿉니다.

약정

COMMITMENT_NAME: 약정의 이름입니다.
REGION: 약정이 있는 리전입니다.
PROJECT_ID: 연결된 예약이 있는 약정을 구매하려는 프로젝트의 ID입니다.
DURATION: 약정 기간입니다(12-month 또는 36-month).
COMMITMENT_TYPE: 약정 유형입니다. 다음 약정 유형은 GPU, 로컬 SSD 디스크 또는 둘 다를 위한 옵션을 제공합니다.
- A2 머신 유형 리소스의 경우 accelerator-optimized
- A3 High 머신 유형 리소스의 경우 accelerator-optimized-a3
- A3 Mega 머신 유형 리소스의 경우 accelerator-optimized-a3-mega
- C2 머신 유형 리소스의 경우 compute-optimized
- C2D 머신 유형 리소스의 경우 compute-optimized-c2d
- C3 머신 유형 리소스의 경우 compute-optimized-c3
- C3D 머신 유형 리소스의 경우 compute-optimized-c3d
- N1 머신 유형 리소스의 경우 general-purpose
- N2 머신 유형 리소스의 경우 general-purpose-n2
- N2D 머신 리소스의 경우 general-purpose-n2d
- G2 머신 유형 리소스의 경우 graphics-optimized
- M3 머신 유형 리소스의 경우 memory-optimized-m3
- Z3 머신 유형 리소스의 경우 storage-optimized-z3
COMMITTED_VCPUS: 약정에 포함할 vCPU 수입니다. 값은 양의 정수여야 합니다.
COMMITTED_MEMORY: 약정에 포함하려는 메모리 크기(MB 또는 GB)입니다. 예를 들면 10GB 또는 10240MB입니다. 단위를 지정하지 않으면 Compute Engine에서 GB가 단위로 사용됩니다. 메모리는 0.25GB 단위로 구매할 수 있습니다.
COMMITTED_LOCAL_SSD: 약정에 포함하려는 로컬 SSD 스토리지의 크기(GB)입니다. 각 로컬 SSD 디스크는 375GB입니다.
COMMITTED_ACCELERATOR_COUNT: 약정에 포함할 GPU 수입니다.
COMMITTED_ACCELERATOR_TYPE: 약정에 포함할 GPU 유형입니다.
YAML_FILE: 연결된 예약의 구성이 포함된 YAML 파일의 경로입니다.

연결된 예약

RESERVATION_NAME: 연결된 예약의 이름입니다.
RESERVATION_ZONE: 연결된 예약의 영역입니다.
REQUIRE_SPECIFIC_RESERVATION_VALUE: 연결된 예약이 특정 대상이 지정된 예약인지 여부를 지정합니다. true 또는 false입니다. 특정 대상이 지정된 예약에 대한 자세한 내용은 예약 작동 방법을 참조하세요.
NUMBER_OF_RESERVED_VMS: 연결된 예약에서 예약하려는 VM 수입니다.
RESERVED_MACHINE_TYPE: 연결된 예약에서 VM에 사용하려는 머신 유형입니다.
- 사전 정의된 머신 유형의 경우 MACHINE_FAMILY-standard-CPUS 형식을 사용합니다(예: n2-standard-4).
- 커스텀 머신 유형의 경우 MACHINE_FAMILY-custom-CPUS-MEMORY 형식을 사용합니다(예: n2-custom-4-5120). 제한사항의 전체 목록은 커스텀 머신 유형의 사양을 참조하세요.
  
  다음을 바꿉니다.
  - MACHINE_FAMILY: 머신 유형의 계열. 예를 들어 N2 VM의 경우 n2를 지정합니다.
  - CPUS: vCPUs의 수입니다.
  - MEMORY: 예약된 VM의 총 메모리입니다. 메모리는 256MB의 배수여야 하며 MB 단위로 제공되어야 합니다. 예를 들어 vCPU 4개, 5GB(5,120MB) 메모리의 N2 VM을 만들려면 n2-custom-4-5120을 사용합니다.
RESERVED_ACCELERATOR_COUNT: 연결된 예약에서 VM당 추가하려는 GPU 수입니다.
RESERVED_ACCELERATOR_TYPE: 연결된 예약에서 추가하려는 가속기 유형입니다.
INTERFACE_1 및 INTERFACE_2: 예약된 각 VM에서 로컬 SSD 디스크에 사용할 인터페이스 유형입니다. 유효한 옵션은 scsi 및 nvme입니다. 각 로컬 SSD 디스크는 375GB입니다. 추가하려는 각 로컬 SSD 디스크에 대해 local_ssd 매개변수를 반복합니다. 로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다.
OWNER_PROJECT_ID: 연결된 예약이 있는 약정을 구매하려는 프로젝트의 ID입니다. 여러 소비자 프로젝트 간에 연결된 예약을 공유하려면 이 필드를 지정합니다.
MINIMUM_CPU_PLATFORM: 연결된 예약에 지정하려는 최소 CPU 플랫폼입니다.
SHARE_SETTING: 연결된 예약의 공유 유형입니다. 여러 소비자 프로젝트 간에 연결된 예약을 공유하려면 이 필드의 값을 projects로 지정합니다. 단일 프로젝트 예약을 만들려면 이 필드를 제외합니다.
CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 이 예약을 공유할 수 있는 프로젝트의 프로젝트 ID입니다(예: project-1 및 project-2). 소비자 프로젝트를 최대 100개까지 포함할 수 있습니다. 이러한 프로젝트는 소유자 프로젝트와 동일한 조직에 있어야 합니다. 기본적으로 프로젝트가 이 예약을 소비하도록 허용되므로 이 예약을 만드는 프로젝트의 ID를 포함하지 마세요. 단일 프로젝트 예약을 만들려면 이러한 필드를 제외합니다.

Compute Engine은 대상 영역에 지정된 머신 유형의 리소스가 충분하고 요청 시 할당량이 충분한 경우에만 약정 및 연결된 예약을 만듭니다. 구매가 성공하면 다음과 비슷한 성공 메시지가 표시됩니다.

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

연결할 새 예약을 만들어서 약정을 구매하는 예시

다음 예시 시나리오 및 명령어는 새 예약을 만들고 이를 약정에 연결해서 GPU나 로컬 SSD 디스크 또는 둘 다에 대한 약정을 구매하는 방법을 보여줍니다.

예시 1: 단일 새 예약을 연결하여 GPU 약정 구매

us-central1 리전에서 NVIDIA V100 GPU 4개가 포함된 commitment-01 약정을 구매한다고 가정해 보세요. 새 예약 reservation-01을 이러한 GPU에 대한 연결된 예약으로 만들어야 합니다. 또한 Compute Engine이 us-central1-a 영역에서 2개의 n1-standard-32 VM에 이러한 예약된 GPU를 사용하도록 지정해야 합니다. 연결된 예약이 있는 이 예시 약정을 구매하려면 다음 명령어를 실행합니다.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

예시 2: vCPU 또는 메모리 약정 없이 GPU에 대한 약정 구매

vCPU 또는 메모리 약정 없이 GPU 및 로컬 SSD 디스크를 약정하고 예약하려면 vCPU 및 메모리 수량의 값으로 0을 지정합니다. 예를 들어 us-west2 리전에서 단일 NVIDIA P4 GPU에 대해 commitment-02 약정을 구매한다고 가정해 보세요. 또한 새 예약을 연결된 예약으로 만들고 Compute Engine이 us-west2-b 영역에서 n1-standard-2 VM에 예약된 GPU를 사용하도록 지정합니다. 연결된 예약이 있는 이 예시 약정을 구매하려면 다음 명령어를 실행합니다.

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

예시 3: 새로운 다중 예약을 연결하여 GPU 및 로컬 SSD 디스크의 약정 구매

us-central1 리전에서 NVIDIA V 100 GPU 1개 및 로컬 SSD 디스크 2개에 대해 commitment-03 약정을 구매한다고 가정해 보세요. 또한 us-central1-a 영역에서 2개의 예약을 만들고 연결하려고 합니다. 첫 번째 예약 res-01에서 GPU 1개가 있는 n1-standard-2 VM 1개를 예약하려고 합니다. res-01을 대상이 지정된 예약으로 만들어야 합니다. 즉, 예약된 VM을 사용하도록 이름별로 예약 대상을 지정해야 합니다. 두 번째 예약 res-02에서 두 가지 유형의 연결된 로컬 SSD 디스크가 있는 n1-standard-8 VM 1개를 예약합니다.

연결된 예약이 있는 이 예시 약정을 구매하려면 먼저 두 예약의 속성을 사용해서 YAML 파일을 만듭니다.

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

YAML 파일을 만든 후 연결된 예약이 있는 약정 구매를 완료하기 위해 다음 명령어를 실행합니다. 예시 약정에는 vCPU 및 메모리 리소스도 포함됩니다.

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

약정을 구매하는 동안 연결된 예약을 만들려면 regionCommitments.insert 메서드에 대해 POST 요청을 수행합니다. 요청에서 reservations 필드를 포함하여 만들고 연결하려는 모든 새 예약 목록을 정의합니다. 기존 예약을 원하는 만큼 약정에 연결할 수 있습니다.

모든 VM 속성을 수동으로 지정하여 새 예약을 만들려면 instanceProperties 필드를 포함하고 sourceInstanceTemplate 필드는 제외합니다.

예를 들어 GPU, 로컬 SSD 디스크 2개, 최소 CPU 플랫폼을 지정하는 2개의 프로젝트와 공유된 공유 예약 구성을 수동으로 지정하려면 다음 요청을 수행합니다.

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

{
"name": "COMMITMENT_NAME",
"plan": "DURATION",
"type": COMMITMENT_TYPE,
"resources":
[
  {
    "amount": "COMMITTED_VCPUS",
    "type": "VCPU"
  },
  {
    "amount": "COMMITTED_MEMORY",
    "type": "MEMORY"
  },
  {
    "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
    "amount": "COMMITTED_ACCELERATOR_COUNT",
    "type": "ACCELERATOR"
  }
  {
    "amount": "COMMITTED_LOCAL_SSD",
    "type": "LOCAL_SSD"
  }
],
"reservations":
[
  {
    "name": "RESERVATION_NAME",
    "specificReservation":
    {
      "count": "NUMBER_OF_RESERVED_VMS",
      "instanceProperties":
      {
        "guestAccelerators":
        [
          {
            "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
            "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
          }
        ],
        "localSsds":
        [
          {
            "diskSizeGb": "375",
            "interface": "RESERVED_INTERFACE_1"
          },
          {
            "diskSizeGb": "375",
            "interface": "RESERVED_INTERFACE_2"
          }
        ],
        "machineType": "RESERVED_MACHINE_TYPE",
        "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
      }
    },
    "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
    "zone": "RESERVED_ZONE",
    "shareSettings":
    {
      "shareType": "SPECIFIC_PROJECTS",
      "projectMap":
      {
        "CONSUMER_PROJECT_ID_1":
        {
          "projectId": "CONSUMER_PROJECT_ID_1"
        },
        "CONSUMER_PROJECT_ID_2":
        {
          "projectId": "CONSUMER_PROJECT_ID_2"
        }
      }
    }
  }
]
}

인스턴스 템플릿을 지정하여 새 예약을 만들려면 sourceInstanceTemplate 필드를 포함하고 instanceProperties 필드는 제외합니다.

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

{
"name": "COMMITMENT_NAME",
"plan": "DURATION",
"type": COMMITMENT_TYPE,
"resources":
[
  {
    "amount": "COMMITTED_VCPUS",
    "type": "VCPU"
  },
  {
    "amount": "COMMITTED_MEMORY",
    "type": "MEMORY"
  },
  {
    "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
    "amount": "COMMITTED_ACCELERATOR_COUNT",
    "type": "ACCELERATOR"
  }
  {
    "amount": "COMMITTED_LOCAL_SSD",
    "type": "LOCAL_SSD"
  }
],
"reservations":
[
  {
    "name": "RESERVATION_NAME",
    "specificReservation":
    {
      "count": "NUMBER_OF_RESERVED_VMS",
      "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    },
    "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
    "zone": "RESERVED_ZONE",
    "shareSettings":
    {
      "shareType": "SPECIFIC_PROJECTS",
      "projectMap":
      {
        "CONSUMER_PROJECT_ID_1":
        {
          "projectId": "CONSUMER_PROJECT_ID_1"
        },
        "CONSUMER_PROJECT_ID_2":
        {
          "projectId": "CONSUMER_PROJECT_ID_2"
        }
      }
    }
  }
]
}

다음을 약정 및 연결된 예약의 해당 속성으로 바꿉니다.

약정

COMMITMENT_NAME: 약정의 이름입니다.
REGION: 약정이 있는 리전입니다.
PROJECT_ID: 연결된 예약이 있는 약정을 구매하려는 프로젝트의 ID입니다.
DURATION: 약정 기간입니다(TWELVE_MONTH 또는 THIRTY_SIX_MONTH).
COMMITMENT_TYPE: 약정 유형입니다. 다음 약정 유형은 GPU, 로컬 SSD 디스크 또는 둘 다를 위한 옵션을 제공합니다.
- A2 머신 유형 리소스의 경우 ACCELERATOR_OPTIMIZED
- A3 High 머신 유형 리소스의 경우 ACCELERATOR_OPTIMIZED_A3
- A3 Mega 머신 유형 리소스의 경우 ACCELERATOR_OPTIMIZED_A3_MEGA
- C2 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED
- C2D 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C2D
- C3 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C3
- C3D 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C3D
- N1 머신 유형 리소스의 경우 GENERAL_PURPOSE
- N2 머신 유형 리소스의 경우 GENERAL_PURPOSE_N2
- N2D 머신 리소스의 경우 GENERAL_PURPOSE_N2D
- G2 머신 유형 리소스의 경우 GRAPHICS_OPTIMIZED
- M3 머신 유형 리소스의 경우 MEMORY_OPTIMIZED_M3
- Z3 머신 유형 리소스의 경우 STORAGE_OPTIMIZED_Z3
COMMITTED_VCPUS: 약정에 포함할 vCPU 수입니다. 값은 양의 정수여야 합니다.
COMMITTED_MEMORY: 약정에 포함하려는 메모리의 크기(MB)입니다. 예를 들면 10240MB입니다. 메모리는 256MB 단위로 구매할 수 있습니다.
COMMITTED_LOCAL_SSD: 약정에 포함하려는 로컬 SSD 스토리지의 크기(GB)입니다. 각 로컬 SSD 디스크는 375GB입니다.
COMMITTED_ACCELERATOR_COUNT: 약정에 포함할 GPU 수입니다.
COMMITTED_ACCELERATOR_TYPE: 약정에 포함할 GPU 유형입니다.

연결된 예약

RESERVATION_NAME: 연결된 예약의 이름입니다.
RESERVATION_ZONE: 연결된 예약의 영역입니다.
REQUIRE_SPECIFIC_RESERVATION_VALUE: 연결된 예약이 특정 대상이 지정된 예약인지 여부를 지정합니다. true 또는 false입니다. 특정 대상이 지정된 예약에 대한 자세한 내용은 예약 작동 방법을 참조하세요.
NUMBER_OF_RESERVED_VMS: 연결된 예약에서 예약하려는 VM 수입니다.
RESERVED_MACHINE_TYPE: 연결된 예약에서 VM에 사용하려는 머신 유형입니다.
- 사전 정의된 머신 유형의 경우 MACHINE_FAMILY-standard-CPUS 형식을 사용합니다(예: n2-standard-4).
- 커스텀 머신 유형의 경우 MACHINE_FAMILY-custom-CPUS-MEMORY 형식을 사용합니다(예: n2-custom-4-5120). 제한사항의 전체 목록은 커스텀 머신 유형의 사양을 참조하세요.
  
  다음을 바꿉니다.
  - MACHINE_FAMILY: 머신 유형의 계열. 예를 들어 N2 VM의 경우 n2를 지정합니다.
  - CPUS: vCPUs의 수입니다.
  - MEMORY: 예약된 VM의 총 메모리입니다. 메모리는 256MB의 배수여야 하며 MB 단위로 제공되어야 합니다. 예를 들어 vCPU 4개, 5GB(5,120MB) 메모리의 N2 VM을 만들려면 n2-custom-4-5120을 사용합니다.
RESERVED_ACCELERATOR_COUNT: 연결된 예약에서 VM당 추가하려는 GPU 수입니다.
RESERVED_ACCELERATOR_TYPE: 연결된 예약에서 추가하려는 가속기 유형입니다.
INTERFACE_1 및 INTERFACE_2: 예약된 각 VM에서 로컬 SSD 디스크에 사용할 인터페이스 유형입니다. 유효한 옵션은 scsi 및 nvme입니다. 각 로컬 SSD 디스크는 375GB입니다. 추가하려는 각 로컬 SSD 디스크에 대해 localSsds 매개변수를 반복합니다. 로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다.
MINIMUM_CPU_PLATFORM: 연결된 예약에 지정하려는 최소 CPU 플랫폼입니다.
INSTANCE_TEMPLATE_NAME: 연결된 예약을 만드는 데 사용하려는 인스턴스 템플릿의 이름입니다.
SHARE_SETTING: 연결된 예약의 공유 유형입니다. 여러 소비자 프로젝트 간에 연결된 예약을 공유하려면 이 필드의 값을 SPECIFIC_PROJECTS로 지정합니다. 단일 프로젝트 예약을 만들려면 이 필드를 제외합니다.
CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2: 이 예약을 공유할 수 있는 프로젝트의 프로젝트 ID입니다(예: project-1 및 project-2). 소비자 프로젝트를 최대 100개까지 포함할 수 있습니다. 이러한 프로젝트는 소유자 프로젝트와 동일한 조직에 있어야 합니다. 기본적으로 프로젝트가 이 예약을 소비하도록 허용되므로 이 예약을 만드는 프로젝트의 ID를 포함하지 마세요. 단일 프로젝트 예약을 만들려면 이러한 필드를 제외합니다.

Compute Engine은 대상 영역에 지정된 머신 유형의 리소스가 충분하고 요청 시 할당량이 충분한 경우에만 약정 및 연결된 예약을 만듭니다. 구매가 성공하면 Compute Engine이 REST API 요청에 대해 200 상태를 반환합니다.

연결할 새 예약을 만들어서 약정을 구매하는 예시

예시 1: 단일 새 예약을 연결하여 GPU 약정 구매

us-central1 리전에서 NVIDIA V100 GPU 4개가 포함된 commitment-01 약정을 구매한다고 가정해 보세요. 새 예약 reservation-01을 이러한 GPU에 대한 연결된 예약으로 만들어야 합니다. 또한 Compute Engine이 us-central1-a 영역에서 2개의 n1-standard-8 VM에 이러한 예약된 GPU를 사용하도록 지정해야 합니다. 연결된 예약이 있는 이 예시 약정을 구매하려면 다음 POST 요청을 수행합니다.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

예시 2: vCPU 또는 메모리 약정 없이 GPU에 대한 약정 구매

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

예시 3: 새로운 다중 예약을 연결하여 GPU 및 로컬 SSD 디스크의 약정 구매

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "768000",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

약정에 연결된 예약 교체

약정된 리소스를 사용하는 VM 유형과 수를 수정하려면 약정의 기존 연결 예약을 새 예약으로 바꿉니다.

교체 예약은 항상 새로 생성된 예약입니다. 연결된 예약을 교체하려면 교체로 사용할 예약의 속성을 지정해야 합니다. 그러면 Compute Engine은 이러한 속성이 있는 새 예약을 자동으로 만들고 이를 사용하여 연결된 예약을 대체합니다. 기존 예약을 사용하여 연결된 예약을 대체할 수 없습니다.

허용된 변경사항

약정의 기존 연결된 예약을 새 예약으로 바꾸면 다음 변경사항을 요청할 수 있습니다.

다른 머신 유형에서 VM을 예약할 수 있습니다. 그러나 예약된 리소스에 CUD를 계속 받으려면 같은 머신 계열에서 VM을 계속 예약해야 합니다.
예약할 VM 수를 변경할 수 있습니다.
예약된 GPU와 로컬 SSD 디스크의 총 수량이 동일하게 유지되는 한 VM당 연결되는 GPU와 로컬 SSD 디스크의 수량을 변경할 수 있습니다.
바뀐 예약을 로컬 예약이나 공유 예약으로 지정할 수 있습니다.

중요: 약정에 연결된 예약이 약정에 포함되지 않은 프로젝트에서 사용되는 경우 할인 가격이 적용되지 않습니다. 연결된 예약이 공유 예약인 경우 약정 사용 할인을 받을 수 있도록 약정에 포함된 프로젝트와만 해당 예약을 공유합니다.

요구사항

약정의 연결된 예약을 새 예약으로 바꿀 때는 요청이 다음 요구사항을 모두 충족해야 합니다.

한 번에 연결된 예약 하나만 새 연결 예약 하나로 바꿀 수 있습니다. 연결된 예약을 바꾸려면 VM 수를 0으로 설정하여 기존 연결된 예약을 동시에 삭제하고 바꾸려는 새로운 연결된 예약을 정의합니다.
새 예약은 약정과 동일한 프로젝트에 있어야 합니다.
새 예약은 삭제된 예약과 동일한 영역에 있어야 합니다.
새 예약에 지정된 GPU 양과 유형은 삭제된 예약과 일치해야 합니다.
새 예약에 지정된 로컬 SSD 디스크의 수와 유형은 삭제된 예약과 일치해야 합니다.
요청당 VM을 최대 100대까지만 변경할 수 있습니다. 100개를 초과하는 VM과 관련된 변경 작업을 수행하려면 변경사항을 여러 개의 작은 요청으로 나누거나 Google Cloud 지원팀에 문의하세요.

예약 교체 요청은 또한 당시의 용량 가용성에 따라 달라집니다. 요청 용량을 사용할 수 없으면 요청이 실패하고 리소스 가용성 오류가 반환됩니다. 요청을 수정하거나 연기해서 오류 해결을 시도할 수 있습니다. 자세한 내용은 리소스 가용성 문제 해결 문서를 참조하세요.

연결된 예약 교체 요청이 실패하더라도 연결된 예약과 기존 예약된 리소스는 영향을 받지 않습니다. 용량을 보존하려면 예약 교체 요청이 성공할 때까지 VM 변경을 기다려야 합니다.

연결된 예약 교체 단계

Google Cloud CLI 또는 REST를 사용하여 약정 예약을 바꿀 수 있습니다.

gcloud

약정에 연결된 예약을 교체하려면 다음을 수행합니다.

다음과 같은 연결된 예약의 구성을 사용해서 현재 디렉토리에 YAML 파일을 만듭니다.
- 바꾸려는 현재 예약입니다.
  
  이 예약의 세부정보를 검색하려면 예약 세부정보 보기를 참조하세요.
- 새로운 교체 예약입니다.
YAML 파일의 콘텐츠는 다음과 비슷합니다.
```
- reservation: CURRENT_RESERVATION_NAME
  reservation_zone: CURRENT_RESERVATION_ZONE
  vm_count: 0
  machine_type: CURRENT_RESERVATION_MACHINE_TYPE
  accelerator:
  - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
    type: CURRENT_RESERVATION_ACCELERATOR_TYPE
  local_ssd:
  - interface: CURRENT_RESERVATION_INTERFACE_1
    size: 375
  - interface: CURRENT_RESERVATION_INTERFACE_2
    size: 375
  project: CURRENT_RESERVATION_PROJECT_ID
  share_setting: CURRENT_RESERVATION_SHARE_SETTING
  share_with:
  - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
  - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
- reservation: REPLACEMENT_RESERVATION_NAME
  reservation_zone: REPLACEMENT_RESERVATION_ZONE
  vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
  machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
  accelerator:
  - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
    type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
  local_ssd:
  - interface: REPLACEMENT_RESERVATION_INTERFACE_1
    size: 375
  - interface: REPLACEMENT_RESERVATION_INTERFACE_2
    size: 375
  project: REPLACEMENT_RESERVATION_PROJECT_ID
  share_setting: REPLACEMENT_RESERVATION_SHARE_SETTING
  share_with:
  - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
  - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
```
다음을 현재 및 교체 예약의 해당 속성으로 바꿉니다.
현재 예약
현재 예약의 경우 다음과 같은 모든 속성이 예약을 봤을 때와 정확하게 동일해야 합니다. 현재 예약에 아직 없는 모든 속성은 필드를 생략합니다.
- CURRENT_RESERVATION_NAME: 현재 연결된 예약의 이름입니다.
- CURRENT_RESERVATION_ZONE: 현재 연결된 예약의 영역입니다.
- CURRENT_RESERVATION_MACHINE_TYPE: 현재 연결된 예약의 머신 유형입니다.
- CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: 현재 연결된 예약에 포함된 GPU 수입니다.
- CURRENT_RESERVATION_ACCELERATOR_TYPE: 현재 연결된 예약에 포함된 가속기 유형입니다.
- CURRENT_RESERVATION_INTERFACE_1 및 CURRENT_RESERVATION_INTERFACE_2: 현재 연결된 예약에서 예약된 각 VM의 로컬 SSD 디스크에 사용되는 인터페이스 유형입니다. 유효한 옵션은 scsi 및 nvme입니다. 각 로컬 SSD 디스크는 375GB입니다. 예약된 모든 로컬 SSD 디스크에 local_ssd 매개변수를 반복합니다.
- CURRENT_RESERVATION_PROJECT_ID: 약정 및 연결된 예약을 포함하는 현재 프로젝트의 프로젝트 ID입니다. 현재 연결된 예약이 여러 소비자 프로젝트 간에 공유된 경우 이 필드를 지정합니다.
- CURRENT_RESERVATION_SHARE_SETTING: 현재 예약의 공유 유형입니다. 현재 연결된 예약이 여러 소비자 프로젝트 간에 공유된 경우 이 필드의 값을 projects로 지정합니다.
- CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 및 CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: 현재 연결된 예약을 공유하는 프로젝트의 프로젝트 ID입니다(예: project-1 및 project-2).
교체 예약
교체 예약의 경우 필요에 따라 다음 속성을 설정합니다. 이러한 속성을 지정할 때는 모든 요구사항을 충족해야 합니다. 사용하지 않으려는 추가 필드는 생략합니다.
- REPLACEMENT_RESERVATION_NAME: 새 교체 예약의 이름입니다.
- REPLACEMENT_RESERVATION_ZONE: 새 교체 예약의 영역입니다.
- REPLACEMENT_RESERVATION_NUMBER_OF_VMS: 새 교체 영역에서 예약하려는 VM 수입니다.
- REPLACEMENT_RESERVATION_MACHINE_TYPE: 새 교체 영역에서 VM에 지정하려는 머신 유형입니다.
  - 사전 정의된 머신 유형의 경우 MACHINE_FAMILY-standard-CPUS 형식을 사용합니다(예: n2-standard-4).
  - 커스텀 머신 유형의 경우 MACHINE_FAMILY-custom-CPUS-MEMORY 형식을 사용합니다(예: n2-custom-4-5120). 제한사항의 전체 목록은 커스텀 머신 유형의 사양을 참조하세요.
  다음을 바꿉니다.
  - MACHINE_FAMILY: 머신 유형의 계열. 예를 들어 N2 VM의 경우 n2를 지정합니다.
  - CPUS: vCPUs의 수입니다.
  - MEMORY: 예약된 VM의 총 메모리입니다. 메모리는 256MB의 배수여야 하며 MB 단위로 제공되어야 합니다. 예를 들어 vCPU 4개, 5GB(5,120MB) 메모리의 N2 VM을 만들려면 n2-custom-4-5120을 사용합니다.
- REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: 교체 예약에서 VM당 추가하려는 GPU 수입니다.
- REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: 교체 예약에서 추가하려는 가속기 유형입니다.
- REPLACEMENT_RESERVATION_INTERFACE_1 및 REPLACEMENT_RESERVATION_INTERFACE_2: 예약된 각 VM에서 로컬 SSD 디스크에 사용할 인터페이스 유형입니다. 유효한 옵션은 scsi 및 nvme입니다. 각 로컬 SSD 디스크는 375GB입니다. 추가하려는 각 로컬 SSD 디스크에 대해 local_ssd 매개변수를 반복합니다. 로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다.
- REPLACEMENT_RESERVATION_PROJECT_ID: 약정 및 연결된 예약을 포함하는 현재 프로젝트의 프로젝트 ID입니다. 여러 소비자 프로젝트 간에 교체 예약을 공유하려면 이 필드를 지정합니다.
- REPLACEMENT_RESERVATION_SHARE_SETTING: 교체 예약의 문자열 유형입니다. 여러 소비자 프로젝트 간에 교체 예약을 공유하려면 이 필드의 값을 projects로 지정합니다.
- REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 및 REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: 이 예약을 공유할 수 있는 프로젝트의 프로젝트 ID입니다(예: project-1,project-2). 소비자 프로젝트를 최대 100개까지 포함할 수 있습니다. 이러한 프로젝트는 소유자 프로젝트와 동일한 조직에 있어야 합니다. 이 예약을 기본적으로 소비할 수 있도록 이미 허용된 REPLACEMENT_RESERVATION_PROJECT_ID는 포함하지 마세요.
gcloud beta compute commitments update-reservations 명령어를 실행하고 --reservations-from-file 플래그를 사용해서 YAML 파일 경로를 지정합니다.
```
gcloud beta compute commitments update-reservations COMMITMENT_NAME \
    --project= PROJECT_ID \
    --region= REGION \
    --reservations-from-file= YAML_FILE
```
다음을 바꿉니다.
- COMMITMENT_NAME: 연결된 예약이 있는 약정 이름입니다.
- PROJECT_ID: 연결된 예약이 있는 약정의 프로젝트 ID입니다.
- REGION: 약정이 있는 리전입니다.
- YAML_FILE: 현재 및 교체 예약의 구성이 포함된 YAML 파일의 경로입니다.

약정에 연결된 예약을 교체하는 예시

이를 설명하기 위해 이 섹션에서는 연결된 예약이 포함된 약정 예시와 연결된 예약 예시를 교체하는 방법을 보여줍니다.

연결된 예약이 포함된 약정 예시

예를 들어 다음 명령어를 사용해서 구입한 my-commitment-with-reservations 약정에 대해 연결된 예약을 업데이트한다고 가정해 보세요.

  gcloud beta compute commitments create my-commitment-with-reservations \
      --region=asia-east1 \
      --resources=vcpu=16,memory=60GB,local-ssd=3000 \
      --resources-accelerator=type=nvidia-tesla-p100,count=4 \
      --plan=12-month \
      --type=general-purpose \
      --reservations-from-file=one-reservation.yaml

이 예시에서는 이 명령어를 실행할 때 one-reservation.yaml이 현재 디렉터리에 있는 파일이고, res-1이라는 연결된 예약을 정의하는 다음 콘텐츠가 포함되었다고 가정합니다.

  - reservation: res-1
    reservation_zone: asia-east1-a
    vm_count: 4
    machine_type: n1-standard-4
    accelerator:
    - count: 1
      type: nvidia-tesla-p100
    local_ssd:
    - interface: scsi
      size: 375
    - interface: scsi
      size: 375

이 my-commitment-with-reservations 약정과 연결된 예약 res-1에 따라 다음과 같은 약정 및 예약된 리소스가 발생했습니다.

리소스 유형	약정의 리소스 (`my-commitment-with-reservations`)	현재 연결된 예약의 리소스 (`res-1`)
vCPU 및 메모리	vCPU 16개 및 60GB	vCPU 16개 및 60GB (예약된 `n1-standard-4` VM 4개)^*
GPU	P100 GPU 4개	P100 GPU 4개 (VM 4개에 대해 VM당 P100 GPU 1개)^*
로컬 SSD 디스크	3,000GB 또는 8개의 로컬 SSD 디스크	3,000GB 또는 로컬 SSD 디스크 8개 (VM 4개에 대해 VM당 750GB 또는 로컬 SSD 디스크 2개)^*

^*특히 연결된 예약 예시 res-1은 n1-standard-4 VM 4개를 예약하며, 각 VM에는 scsi 인터페이스 유형의 P100 GPU 1개 및 로컬 SSD 디스크 2개가 포함됩니다. n1-standard-4 머신 유형은 각 VM에 대해 vCPU 4개와 15GB를 사용합니다.

연결된 예약 예시 바꾸기

연결된 예약 res-1을 새로운 연결된 예약 res-2로 바꾸고 예약된 리소스를 다음과 같이 변경한다고 가정해 보세요.

리소스 유형	약정의 리소스 (`my-commitment-with-reservations`)	현재 연결된 예약의 리소스 (`res-1`)	연결된 교체 예약의 리소스 (`res-2`)
vCPU 및 메모리	vCPU 16개 및 60GB	vCPU 16개 및 60GB (예약된 `n1-standard-4` VM 4개)^*	vCPU 16개 및 60GB (예약 및 공유된 `n1-standard-8` VM 2개)^†
GPU	P100 GPU 4개	P100 GPU 4개 (VM 4개에 대해 VM당 P100 GPU 1개)^*	P100 GPU 4개 (VM 2개에 대해 VM당 P100 GPU 2개)^†
로컬 SSD 디스크	3,000GB 또는 8개의 로컬 SSD 디스크	3,000GB 또는 로컬 SSD 디스크 8개 (VM 4개에 대해 VM당 750GB 또는 로컬 SSD 디스크 2개)^*	3,000GB 또는 로컬 SSD 디스크 8개 (VM 2개에 대해 VM당 1,500GB 또는 로컬 SSD 디스크 4개)^*

^†특히 연결된 교체 예약은 n1-standard-8 VM 2개를 예약하는 res-2를 정의합니다. 각 VM에는 scsi 인터페이스 유형의 P100 GPU 1개 및 로컬 SSD 디스크 4개가 포함됩니다. 또한 res-2는 2개의 다른 프로젝트 project-1 및 project-2에 공유되고 현재 프로젝트 my-project의 소유입니다. n1-standard-8 머신 유형은 각 VM에 대해 vCPU 8개 및 30GB를 사용합니다.

my-commitment-with-reservations 약정에 대해 연결된 예약 res-1을 res-2로 바꾸려면 다음을 수행합니다.

현재 디렉터리에 다음 콘텐츠가 포함된 two-reservations.yaml이라는 파일을 만듭니다.

- reservation: res-1
  reservation_zone: asia-east1-a
  vm_count: 0
  machine_type: n1-standard-4
  accelerator:
  - count: 1
    type: nvidia-tesla-p100
  local_ssd:
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375
- reservation: res-2
  reservation_zone: asia-east1-a
  vm_count: 2
  machine_type: n1-standard-8
  accelerator:
  - count: 2
    type: nvidia-tesla-p100
  project: my-project
  share_setting: projects
  share_with:
  - project-1
  - project-2
  local_ssd:
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375

다음 명령어를 실행합니다.

gcloud beta compute commitments update-reservations my-commitment-with-reservations \
    --region=asia-east1 \
    --reservations-from-file=two-reservations.yaml

REST

약정에 연결된 예약을 바꾸려면 regionCommitments.updateReservations 메서드를 사용해서 POST 요청을 수행합니다.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/COMMITMENT_ZONE/commitments/COMMITMENT_NAME/updateReservations

{
  "reservations":
  [
    {
      "name": "REPLACEMENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "REPLACEMENT_RESERVATION_NUMBER_OF_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "REPLACEMENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "REPLACEMENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "REPLACEMENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    },
    {
      "name": "CURRENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "0",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "CURRENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "CURRENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "CURRENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    }
  ]
}

다음을 약정의 해당 속성, 현재 예약, 교체 예약으로 바꿉니다.

약정

COMMITMENT_NAME: 연결된 예약이 있는 약정 이름입니다.
PROJECT_ID: 연결된 예약이 있는 약정의 프로젝트 ID입니다. 또한 현재 및 연결된 약정의 프로젝트 ID입니다.
COMMITMENT_ZONE: 연결된 예약이 있는 약정의 영역입니다.

현재 예약

현재 예약의 경우 다음과 같은 모든 속성이 예약을 봤을 때와 정확하게 동일해야 합니다. 현재 예약에 아직 지정되지 않은 모든 속성은 필드를 생략합니다.

CURRENT_RESERVATION_NAME: 현재 연결된 예약의 이름입니다.
CURRENT_RESERVATION_ZONE: 현재 연결된 예약의 영역입니다.
CURRENT_RESERVATION_MACHINE_TYPE: 현재 연결된 예약의 머신 유형입니다.
CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: 현재 연결된 예약에 포함된 GPU 수입니다.
CURRENT_RESERVATION_ACCELERATOR_TYPE: 현재 연결된 예약에 포함된 가속기 유형입니다.
CURRENT_RESERVATION_INTERFACE_1 및 CURRENT_RESERVATION_INTERFACE_2: 현재 연결된 예약에서 예약된 각 VM의 로컬 SSD 디스크에 사용되는 인터페이스 유형입니다. 유효한 옵션은 scsi 및 nvme입니다. 각 로컬 SSD 디스크는 375GB입니다. 예약된 모든 로컬 SSD 디스크에 localSsds 매개변수를 반복합니다.
CURRENT_RESERVATION_SHARE_SETTING: 현재 예약의 공유 유형입니다. 현재 연결된 예약이 여러 소비자 프로젝트 간에 공유된 경우 이 매개변수의 값을 projects로 지정합니다.
CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 및 CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: 현재 연결된 예약을 공유하는 프로젝트의 프로젝트 ID입니다(예: project-1 및 project-2).

교체 예약

교체 예약의 경우 필요에 따라 다음 속성을 설정합니다. 이러한 속성을 지정할 때는 모든 요구사항을 충족해야 합니다. 사용하지 않으려는 추가 필드는 생략합니다.

REPLACEMENT_RESERVATION_NAME: 새 교체 예약의 이름입니다.
REPLACEMENT_RESERVATION_ZONE: 새 교체 예약의 영역입니다.
REPLACEMENT_RESERVATION_NUMBER_OF_VMS: 새 교체 영역에서 예약하려는 VM 수입니다.
REPLACEMENT_RESERVATION_MACHINE_TYPE: 새 교체 영역에서 VM에 지정하려는 머신 유형입니다.
- 사전 정의된 머신 유형의 경우 MACHINE_FAMILY-standard-CPUS 형식을 사용합니다(예: n2-standard-4).
- 커스텀 머신 유형의 경우 MACHINE_FAMILY-custom-CPUS-MEMORY 형식을 사용합니다(예: n2-custom-4-5120). 제한사항의 전체 목록은 커스텀 머신 유형의 사양을 참조하세요.
다음을 바꿉니다.
- MACHINE_FAMILY: 머신 유형의 계열. 예를 들어 N2 VM의 경우 n2를 지정합니다.
- CPUS: vCPUs의 수입니다.
- MEMORY: 예약된 VM의 총 메모리입니다. 메모리는 256MB의 배수여야 하며 MB 단위로 제공되어야 합니다. 예를 들어 vCPU 4개, 5GB(5,120MB) 메모리의 N2 VM을 만들려면 n2-custom-4-5120을 사용합니다.
REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: 교체 예약에서 VM당 추가하려는 GPU 수입니다.
REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: 교체 예약에서 추가하려는 가속기 유형입니다.
REPLACEMENT_RESERVATION_INTERFACE_1 및 REPLACEMENT_RESERVATION_INTERFACE_2: 예약된 각 VM에서 로컬 SSD 디스크에 사용할 인터페이스 유형입니다. 유효한 옵션은 scsi 및 nvme입니다. 각 로컬 SSD 디스크는 375GB입니다. 추가하려는 각 로컬 SSD 디스크에 대해 localSsds 매개변수를 반복합니다. 로컬 SSD 디스크를 최대 24개까지 지정할 수 있습니다.
REPLACEMENT_RESERVATION_SHARE_SETTING: 교체 예약의 문자열 유형입니다. 여러 소비자 프로젝트 간에 교체 예약을 공유하려면 이 매개변수의 값을 projects로 지정합니다.
REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 및 REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: 이 예약을 공유할 수 있는 프로젝트의 프로젝트 ID입니다(예: project-1,project-2). 소비자 프로젝트를 최대 100개까지 포함할 수 있습니다. 이러한 프로젝트는 소유자 프로젝트와 동일한 조직에 있어야 합니다. 이 예약을 기본적으로 소비할 수 있도록 이미 허용된 PROJECT_ID는 포함하지 마세요.

약정에 연결된 예약을 교체하는 예시

이를 설명하기 위해 이 섹션에서는 연결된 예약이 포함된 약정 예시와 연결된 예약 예시를 교체하는 방법을 보여줍니다.

연결된 예약이 포함된 약정 예시

예를 들어 다음 POST 요청을 수행하여 구입한 my-commitment-with-reservations 약정에 대해 연결된 예약 res-1을 바꾼다고 가정해 보세요.

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments

  {
    "name": "my-commitment-with-reservations",
    "plan": "TWELVE_MONTH",
    "reservations":
    [
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "4",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "1",
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ],
    "resources":
    [
      {
        "amount": "16",
        "type": "VCPU"
      },
      {
        "amount": "61440",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "nvidia-tesla-p100",
        "amount": "4",
        "type": "ACCELERATOR"
      }
      {
        "amount": "3072000",
        "type": "LOCAL_SSD"
      }
    ],
    "type": "GENERAL_PURPOSE"
  }

이 my-commitment-with-reservations 약정과 연결된 예약 res-1에 따라 다음과 같은 약정 및 예약된 리소스가 발생했습니다.

리소스 유형	약정의 리소스 (`my-commitment-with-reservations`)	현재 연결된 예약의 리소스 (`res-1`)
vCPU 및 메모리	vCPU 16개 및 60GB	vCPU 16개 및 60GB (예약된 `n1-standard-4` VM 4개)^*
GPU	P100 GPU 4개	P100 GPU 4개 (VM 4개에 대해 VM당 P100 GPU 1개)^*
로컬 SSD 디스크	3,000GB 또는 8개의 로컬 SSD 디스크	3,000GB 또는 로컬 SSD 디스크 8개 (VM 4개에 대해 VM당 750GB 또는 로컬 SSD 디스크 2개)^*

연결된 예약 예시 바꾸기

연결된 예약 res-1을 새로운 연결된 예약 res-2로 바꾸고 예약된 리소스를 다음과 같이 변경한다고 가정해 보세요.

리소스 유형	약정의 리소스 (`my-commitment-with-reservations`)	현재 연결된 예약의 리소스 (`res-1`)	연결된 교체 예약의 리소스 (`res-2`)
vCPU 및 메모리	vCPU 16개 및 60GB	vCPU 16개 및 60GB (예약된 `n1-standard-4` VM 4개)^*	vCPU 16개 및 60GB (예약 및 공유된 `n1-standard-8` VM 2개)^†
GPU	P100 GPU 4개	P100 GPU 4개 (VM 4개에 대해 VM당 P100 GPU 1개)^*	P100 GPU 4개 (VM 2개에 대해 VM당 P100 GPU 2개)^†
로컬 SSD 디스크	3,000GB 또는 8개의 로컬 SSD 디스크	3,000GB 또는 로컬 SSD 디스크 8개 (VM 4개에 대해 VM당 750GB 또는 로컬 SSD 디스크 2개)^*	3,000GB 또는 로컬 SSD 디스크 8개 (VM 2개에 대해 VM당 1,500GB 또는 로컬 SSD 디스크 4개)^*

my-commitment-with-reservations 약정에 대해 연결된 예약 res-1을 res-2로 바꾸려면 regionCommitments.updateReservations 메서드를 사용해서 다음 POST 요청을 수행합니다.

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments/my-commitment-with-reservations/updateReservations

  {
    "reservations":
    [
      {
        "name": "res-2",
        "specificReservation":
        {
          "count": "2",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 2,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-8"
          }
        },
        "zone": "asia-east1-a"
      },
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "0",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 1,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ]
  }

다음 단계

리소스 기반 CUD 자세히 알아보기
예약 소비 방법 알아보기
예약 수정 방법 알아보기
예약 삭제 방법 알아보기

예약과 약정 사용 할인 조합

시작하기 전에

Console

gcloud

REST

예약된 리소스의 CUD

리소스 기반 약정에 예약 연결

연결된 예약이 필요하지 않은 약정 리소스

연결된 예약이 필요한 약정된 리소스

연결된 예약에 허용되는 리소스 수량

연결된 예약이 있는 약정 구매

요구사항

기존 예약 연결

이 태스크에 필요한 권한

콘솔

gcloud

예시: 기존 예약을 연결하여 약정 구매

REST

예시: 기존 예약을 연결하여 약정 구매

연결할 새 예약 만들기

이 태스크에 필요한 권한

콘솔

gcloud

약정

연결된 예약

연결할 새 예약을 만들어서 약정을 구매하는 예시

예시 1: 단일 새 예약을 연결하여 GPU 약정 구매

예시 2: vCPU 또는 메모리 약정 없이 GPU에 대한 약정 구매

예시 3: 새로운 다중 예약을 연결하여 GPU 및 로컬 SSD 디스크의 약정 구매

REST

약정

연결된 예약

연결할 새 예약을 만들어서 약정을 구매하는 예시

예시 1: 단일 새 예약을 연결하여 GPU 약정 구매

예시 2: vCPU 또는 메모리 약정 없이 GPU에 대한 약정 구매

예시 3: 새로운 다중 예약을 연결하여 GPU 및 로컬 SSD 디스크의 약정 구매

약정에 연결된 예약 교체

허용된 변경사항

요구사항

연결된 예약 교체 단계

gcloud

현재 예약

교체 예약

약정에 연결된 예약을 교체하는 예시

연결된 예약이 포함된 약정 예시

연결된 예약 예시 바꾸기

REST

약정

현재 예약

교체 예약

약정에 연결된 예약을 교체하는 예시

연결된 예약이 포함된 약정 예시

연결된 예약 예시 바꾸기

다음 단계