예약과 약정 사용 할인 조합

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 디스크 또는 둘 다를 위한 옵션을 제공합니다.

  • 머신 유형 리소스의 경우 accelerator-optimized
  • C2 머신 유형 리소스의 경우 compute-optimized
  • C2D 머신 유형 리소스의 경우 compute-optimized-c2d
  • C3 머신 유형 리소스의 경우 compute-optimized-c3
  • C3D 머신 유형 리소스의 경우 compute-optimized-c3d
  • N1 머신 유형 리소스의 경우 general-purpose
  • E2 머신 유형 리소스의 경우 general-purpose-e2
  • N2 머신 유형 리소스의 경우 general-purpose-n2
  • N2D 머신 리소스의 경우 general-purpose-n2d
  • Tau T2D 머신 유형 리소스의 경우 general-purpose-t2d
  • G2 머신 유형 리소스의 경우 graphics-optimized
  • M1 또는 M2 머신 유형 리소스의 경우 memory-optimized
  • 메모리 최적화 M3 머신 유형의 경우 memory-optimized-m3

• 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 디스크 또는 둘 다를 위한 옵션을 제공합니다.

  • E2 머신 유형 리소스의 경우 GENERAL_PURPOSE_E2
  • N2 머신 유형 리소스의 경우 GENERAL_PURPOSE_N2
  • N2D 머신 리소스의 경우 GENERAL_PURPOSE_N2D
  • C3 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C3
  • C3D 머신 유형 리소스의 경우 GENERAL_PURPOSE_C3D
  • Tau T2D 머신 유형 리소스의 경우 GENERAL_PURPOSE_T2D
  • N1 머신 유형 리소스의 경우 GENERAL_PURPOSE
  • C2 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED
  • C2D 머신 유형 리소스의 경우 COMPUTE_OPTIMIZED_C2D
  • M1 또는 M2 머신 유형 리소스의 경우 MEMORY_OPTIMIZED
  • 메모리 최적화 M3 머신 유형의 경우 MEMORY_OPTIMIZED_M3
  • 머신 유형 리소스의 경우 ACCELERATOR_OPTIMIZED
  • G2 머신 유형 리소스의 경우 GRAPHICS_OPTIMIZED

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

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

   약정 사용 할인으로 이동

2. 새 약정을 구매하려면 약정 구매를 클릭합니다.

3. 약정 이름을 지정하고 적용할 리전을 선택합니다.

4. 약정 유형을 선택합니다. 다음 약정 유형은 GPU, 로컬 SSD 디스크 또는 둘 다를 위한 옵션을 제공합니다.

   • C3 머신 유형 리소스의 경우 범용 C3
   • C3D 머신 유형 리소스의 경우 범용 C3D
   • N2 머신 유형 리소스의 경우 범용 N2
   • N2D 머신 유형 리소스의 경우 범용 N2D
   • N1 머신 유형 리소스의 경우 범용 N1
   • H3 머신 유형 리소스의 경우 컴퓨팅 최적화 H3
   • C2 머신 유형 리소스의 경우 컴퓨팅 최적화 C2
   • C2D 머신 유형 리소스의 경우 컴퓨팅 최적화 C2D
   • M1 및 M2 머신 유형 리소스의 경우 메모리 최적화 M1/M2
   • M3 머신 유형 리소스의 경우 메모리 최적화 M3
   • A3 머신 유형 리소스의 경우 가속기 최적화 A3
   • A2 머신 유형 리소스의 경우 가속기 최적화 A2
   • G2 머신 유형 리소스의 경우 그래픽 최적화 G2

5. 약정 기간을 1년 또는 3년으로 선택합니다.

6. 구매하려는 코어와 메모리 수량을 입력합니다. vCPU와 메모리에 대한 약정 없이 GPU 또는 로컬 SSD 디스크만 약정하고 예약하려면 vCPU와 메모리 약정 수량을 0으로 지정합니다.

7. GPU 추가를 클릭하고 약정할 GPU 유형 및 GPU 수를 선택합니다.

8. 로컬 SSD 추가를 클릭하고 약정할 디스크 수를 지정합니다.

9. 예약을 만들고 약정에 연결하려면 예약 추가를 클릭합니다.

   1. 이름 필드에 예약 이름을 입력합니다.
   2. 리소스를 예약할 리전 및 영역을 선택합니다.
   3. 원하는 공유 유형을 선택합니다.
      • 단일 프로젝트에 대한 예약을 만들려면 로컬을 선택합니다.
      • 여러 프로젝트 간에 공유 예약을 만들려면 공유를 선택합니다. 이 예약을 다른 프로젝트와 공유하려면 add 프로젝트 추가를 클릭하고 현재 프로젝트의 조직에서 원하는 프로젝트를 선택합니다.

   4. VM 인스턴스와 함께 사용 필드에서 다음 옵션 중 하나를 선택합니다.

      • 이름을 통해 이 예약을 명시적으로 타겟팅하는 일치하는 VM을 만들 때만 이 예약의 리소스를 ���용하려면 특정 예약 선택을 선택합니다.
      • 일치하는 VM 인스턴스에서 이 예약을 자동으로 사용하도록 허용하려면 예약 자동 사용을 선택합니다.

   5. VM 인스턴스 수 필드에 예약할 VM 인스턴스 수를 입력합니다.

   6. VM 인스턴스마다 예약할 리소스를 지정합니다.

      • 기존 인스턴스 템플릿과 일치하는 VM을 예약하려면 인스턴스 템플릿 사용을 선택하고 목록에서 인스턴스 템플릿을 선택합니다.
      • 또는 머신 유형 지정을 선택하고 다음을 지정합니다.
        1. 머신 계열 필드에서 범용, 컴퓨팅 최적화, 메모리 최적화 또는 GPU 머신 계열을 선택합니다.
        2. 시리즈 및 머신 유형 필드에서 머신 시리즈와 머신 유형을 선택합니다.
        3. 선택사항: 최소 CPU 플랫폼 또는 GPU를 지정합니다.
           1. CPU 플랫폼 및 GPU를 클릭하여 섹션을 펼칩니다.
           2. 선택사항: 최소 CPU 플랫폼을 지정하려면 CPU 플랫폼 목록에서 옵션을 선택합니다.
           3. 선택사항: GPU를 추가하려면 add GPU 추가를 클릭합니다. 그런 다음 GPU 유형 필드와 GPU 수 필드에서 각 VM의 GPU 유형과 수를 선택합니다.
        4. 선택사항: 로컬 SSD 디스크를 추가합니다.
           1. 디스크 수 필드에서 각 VM의 로컬 SSD 디스크 수를 선택합니다.
           2. 인터페이스 유형 필드에서 로컬 SSD 디스크의 인터페이스를 선택합니다.

   7. 이 예약의 속성 지정을 완료하려면 완료를 클릭합니다.

10. 구매 버튼을 클릭하여 약정을 구매합니다.

11. 구매 약관을 읽고 약정을 구매할 준비가 되면 구매를 클릭합니다.

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 파일 방법을 사용해서 단일 예약을 만들고 약정에 연결할 수도 있습니다. 이 방법을 사용해서 연결된 예약을 만들려면 다음을 수행합니다.

  1. 현재 디렉터리에 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
     
     

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

  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
     

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

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

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

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

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

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

예시 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에 대한 약정 구매

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

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 디스크의 약정 구매

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개를 예약합니다. 연결된 예약이 있는 이 예시 약정을 구매하려면 다음 POST 요청을 수행합니다. 예시 약정에는 vCPU 및 메모리 리소스도 포함됩니다.

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

gcloud

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

1. 다음과 같은 연결된 예약의 구성을 사용해서 현재 디렉토리에 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
     localssd:
     - 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
     localssd:
     - 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: vCPU의 수입니다.
     • 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는 포함하지 마세요.

2. 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=3000GB \
      --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에 따라 다음과 같은 약정 및 예약된 리소스가 발생했습니다.

^*특히 연결된 예약 예시 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로 바꾸고 예약된 리소스를 다음과 같이 변경한다고 가정해 보세요.

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

^†특히 연결된 교체 예약은 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로 바꾸려면 다음을 수행합니다.

1. 현재 디렉터리에 다음 콘텐츠가 포함된 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
   

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

   gcloud beta compute commitments update-reservations my-commitment-with-reservations \
       --region=asia-east1-a \
       --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"
          }
         }
      }
    }
  ]
}

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

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

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

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

예를 들어 다음 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에 따라 다음과 같은 약정 및 예약된 리소스가 발생했습니다.

^*특히 연결된 예약 예시 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로 바꾸고 예약된 리소스를 다음과 같이 변경한다고 가정해 보세요.

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

^†특히 연결된 교체 예약은 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로 바꾸려면 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"
      }
    ]
  }