캘린더 모드에서 미래용 예약 요청 만들기

콘솔

캘린더 모드에서 미래용 예약 요청을 만들 때 리전의 GPU VM 또는 TPU 미래 가용성을 확인할 수 있습니다. 자세한 내용은 이 문서의 GPU VM 또는 TPU 예약 요청 만들기를 참고하세요.

gcloud

리전에서 GPU VM 또는 TPU 미래 가용성을 보려면 다음 gcloud beta compute advice calendar-mode 명령어 중 하나를 사용합니다. 확인하려는 리소스에 따라 다음 플래그를 포함합니다.

• GPU VM 가용성을 확인하려면 --vm-count 및 --machine-type 플래그를 포함합니다.

  gcloud beta compute advice calendar-mode \
      --vm-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

• TPU 가용성을 확인하려면 --chip-count 및 --tpu-version 플래그를 포함하세요.

  gcloud beta compute advice calendar-mode \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

다음을 바꿉니다.

• NUMBER_OF_VMS: 예약할 GPU VM 수

• MACHINE_TYPE: 예약할 GPU 머신 유형입니다.

• NUMBER_OF_CHIPS: 예약할 TPU 칩 수입니다.

• TPU_VERSION: 예약할 TPU 버전입니다. 다음 값 중 하나를 지정합니다.

  • TPU v6e: V6E

  • TPU v5p: V5P

  • TPU v5e: V5E

  TPU v5e를 지정하는 경우 --workload-type 플래그를 포함해야 합니다. 이 플래그를 TPU에서 실행하려는 워크로드 유형으로 설정합니다.

  • 머신러닝 (ML) 학습 워크로드와 같이 단일 또는 여러 작업에서 대량의 데이터를 처리하는 워크로드의 경우 BATCH를 지정합니다.

  • 동시 요청을 처리하고 최소한의 네트워크 지연 시간이 필요한 워크로드(예: ML 추론 워크로드)의 경우 SERVING를 지정합니다.

• REGION: GPU VM 또는 TPU를 예약할 리전입니다. 지원되는 리전 및 영역을 확인하려면 이 문서의 제한사항을 참고하세요.

• FROM_START_TIME 및 TO_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를 지정합니다.

• FROM_END_TIME 및 TO_END_TIME: 용량 예약이 종료되기를 원하는 가장 빠른 날짜와 가장 늦은 날짜입니다. 이 날짜를 RFC 3339 타임스탬프로 형식 지정해 줘. 종료 시간 대신 예약 기간의 범위를 지정하려면 --end-time-range 플래그를 --duration-range 플래그로 바꿉니다.

출력은 다음과 비슷합니다.

- recommendationsPerSpec:
    spec:
      endTime: '2025-09-07T00:00:00Z'
      location: zones/us-east5-a
      otherLocations:
        zones/us-east5-b:
          details: this machine family is not supported in this zone
          status: NOT_SUPPORTED
        zones/us-east5-c:
          details: this machine family is not supported in this zone
          status: NOT_SUPPORTED
      recommendationId: 0d3f005d-f952-4fce-96f2-6af25e1591eb
      recommendationType: FUTURE_RESERVATION
      startTime: '2025-06-09T00:00:00Z'

요청한 리소스를 사용할 수 있는 경우 출력에 startTime, endTime, location 필드가 포함됩니다. 이러한 필드는 리소스를 사용할 수 있는 가장 빠른 시작 시간, 가장 늦은 종료 시간, 영역을 지정합니다.

REST

리전에서 GPU VM 또는 TPU의 향후 가용성을 보려면 베타 advice.calendarMode 메서드에 대해 GET 요청을 수행합니다. 확인하려는 리소스에 따라 요청 본문에 다음 필드를 포함합니다.

• GPU VM 가용성을 보려면 instanceCount 및 machineType 필드를 포함하세요.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "specificSkuResources": {
            "instanceCount": "NUMBER_OF_VMS",
            "machineType": "MACHINE_TYPE"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

• TPU 가용성을 확인하려면 acceleratorCount 및 vmFamily 필드를 포함하세요.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "aggregateResources": {
            "acceleratorCount": "NUMBER_OF_CHIPS",
            "vmFamily": "TPU_VERSION"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

다음을 바꿉니다.

• PROJECT_ID: 리소스를 예약하려는 프로젝트의 ID입니다.

• REGION: GPU VM 또는 TPU를 예약할 리전입니다. 지원되는 리전과 영역을 확인하려면 이 문서의 제한사항을 참고하세요.

• NUMBER_OF_VMS: 예약할 GPU VM 수

• MACHINE_TYPE: 예약할 GPU 머신 유형입니다.

• NUMBER_OF_CHIPS: 예약할 TPU 칩 수입니다.

• TPU_VERSION: 예약할 TPU 버전입니다. 다음 값 중 하나를 지정합니다.

  • TPU v6e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

  • TPU v5p: VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

  • TPU v5e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

  TPU v5e를 지정하는 경우 aggregateResources 필드에 workloadType 필드를 포함해야 합니다. 이 필드를 TPU에서 실행할 워크로드 유형으로 설정합니다.

  • 머신러닝 (ML) 학습 워크로드와 같이 단일 또는 여러 작업에서 대량의 데이터를 처리하는 워크로드의 경우 BATCH를 지정합니다.

  • 동시 요청을 처리하고 최소한의 네트워크 지연 시간이 필요한 워크로드(예: ML 추론 워크로드)의 경우 SERVING를 지정합니다.

• FROM_START_TIME 및 TO_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를 지정합니다.

• FROM_END_TIME 및 TO_END_TIME: 용량 예약이 종료되기를 원하는 가장 빠른 날짜와 가장 늦은 날짜입니다. 이 날짜를 RFC 3339 타임스탬프로 형식 지정해 줘. 종료 시간 대신 예약 기간의 기간 범위를 지정하려면 endTimeNotEarlierThan 및 endTimeNotLaterThan 필드를 minDuration 및 maxDuration 필드로 바꿉니다.

출력은 다음과 비슷합니다.

{
  "recommendations": [
    {
      "recommendationsPerSpec": {
        "spec": {
          "recommendationId": "a21a2fa0-72c7-4105-8179-88de5409890b",
          "recommendationType": "FUTURE_RESERVATION",
          "startTime": "2025-06-09T00:00:00Z",
          "endTime": "2025-09-07T00:00:00Z",
          "otherLocations": {
            "zones/us-east5-b": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            },
            "zones/us-east5-c": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            }
          },
          "location": "zones/us-east5-a"
        }
      }
    }
  ]
}

요청한 리소스를 사용할 수 있는 경우 출력에 startTime, endTime, location 필드가 포함됩니다. 이러한 필드는 리소스를 사용할 수 있는 가장 빠른 시작 시간, 가장 늦은 종료 시간, 영역을 지정합니다.

콘솔

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

   예약으로 이동

2. 미래용 예약 탭을 클릭합니다.

3. add_box 미래용 예약 만들기를 클릭합니다. 미래용 예약 만들기 페이지가 표시되고 하드웨어 구성 창이 선택됩니다.

4. 구성 섹션에서 다음 중 하나를 수행하여 예약하려는 GPU VM 또는 TPU의 속성을 지정합니다.

   • GPU VM 또는 TPU 속성을 직접 지정하려면 다음 단계를 완료하세요.

     1. 머신 유형 지정을 선택합니다.

     2. GPU 또는 TPU 탭을 클릭한 다음 예약할 GPU 머신 유형 또는 TPU 버전을 선택합니다.

   • 기존 인스턴스 템플릿을 사용하여 GPU VM 속성을 지정하려면 인스턴스 템플릿을 선택한 다음 템플릿을 선택합니다.

   • 기존 VM을 참조로 사용하여 GPU VM 속성을 지정하려면 기존 VM 사용을 선택한 후 VM을 선택합니다.

5. 이전 단계에서 TPU v5e (CT5LP)를 지정한 경우 TPU v5 워크로드 유형 목록에서 다음 옵션 중 하나를 선택합니다.

   • 단일 또는 여러 작업에서 대량의 데이터를 처리하는 TPU에서 워크로드를 실행하려면(예: ML 학습 워크로드) 일괄을 선택합니다.

   • 동시 요청을 처리하고 ML 추론 워크로드와 같이 최소한의 네트워크 지연 시간이 필요한 TPU에서 워크로드를 실행하려면 서빙을 선택합니다.

6. 용량 검색 섹션에서 다음 단계를 완료합니다.

   1. 리전 및 영역 목록에서 리소스를 예약할 리전과 영역을 지정합니다. 지원되는 리전과 영역을 검토하려면 이 문서의 제한사항을 참고하세요.

   2. 필요한 총 용량 필드 (GPU VM 예약 시) 또는 칩 수 목록 (TPU 예약 시)에서 예약할 GPU VM 또는 TPU 칩 수를 지정합니다.

   3. 시작 시간 목록에서 요청의 시작 시간을 선택합니다.

   4. 선택사항: 시작일 유연성 선택 목록에서 시작일의 정확도를 선택합니다.

   5. 예약 기간 필드에서 리소스를 예약할 기간을 지정합니다.

   6. 용량 검색을 클릭합니다. 그런 다음 사용 가능한 용량 표에서 예약할 GPU VM 또는 TPU의 유형, 수, 예약 기간이 포함된 사용 가능한 옵션 중 하나를 선택합니다.

7. 다음을 클릭합니다.

8. 공유 유형 섹션에서 요청한 용량을 공유할 프로젝트를 선택합니다.

   • 프로젝트 내에서만 예약된 용량을 사용하려면 로컬을 선택합니다.

   • 예약된 용량을 다른 프로젝트와 공유하려면 공유를 선택하고 add 프로젝트 추가를 클릭한 다음 메시지에 따라 프로젝트를 선택합니다.

9. 다음을 클릭합니다.

10. 미래용 예약 이름 필드에 요청 이름을 입력합니다.

11. 예약 이름 필드에 Compute Engine이 요청된 용량을 프로비저닝하기 위해 자동으로 만드는 예약의 이름을 입력합니다.

12. 만들기를 클릭합니다.

gcloud

캘린더 모드에서 미래용 예약 요청을 만들고 검토를 위해 제출하려면 다음 gcloud beta compute future-reservations create 명령어 중 하나를 사용합니다. 예약하려는 리소스에 따라 다음 플래그를 포함합니다.

• GPU VM을 예약하려면 --total-count 및 --machine-type 플래그를 포함합니다.

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --total-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --deployment-type=DENSE \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

• TPU를 예약하려면 --chip-count 및 --tpu-version 플래그를 포함합니다.

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --deployment-type=DENSE \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

다음을 바꿉니다.

• FUTURE_RESERVATION_NAME: 요청의 이름입니다.

• NUMBER_OF_VMS: 예약할 GPU VM 수

• MACHINE_TYPE: 예약할 GPU 머신 유형입니다.

• NUMBER_OF_CHIPS: 예약할 TPU 칩 수입니다.

• TPU_VERSION: 예약할 TPU 버전입니다. 다음 값 중 하나를 지정합니다.

  • TPU v6e: V6E

  • TPU v5p: V5P

  • TPU v5e: V5E

  TPU v5e를 지정하는 경우 --workload-type 플래그를 포함해야 합니다. 플래그를 TPU에서 실행할 워크로드 유형으로 설정합니다.

  • 머신러닝 (ML) 학습 워크로드와 같이 단일 또는 여러 작업에서 대량의 데이터를 처리하는 워크로드의 경우 BATCH를 지정합니다.

  • 동시 요청을 처리하고 최소한의 네트워크 지연 시간이 필요한 워크로드(예: ML 추론 워크로드)의 경우 SERVING를 지정합니다.

• RESERVATION_NAME: Compute Engine에서 요청된 용량을 프로비저닝하기 위해 자동으로 생성하는 예약의 이름입니다.

• SHARE_TYPE: 조직의 다른 프로젝트에서 예약된 용량을 사용할 수 있는지 여부입니다. 다음 값 중 하나를 지정합니다.

  • 프로젝트 내에서만 용량을 사용하려면 다음을 실행하세요. local

  • 다른 프로젝트와 용량을 공유하려면 다음 단계를 따르세요. projects

  projects를 지정하는 경우 --share-with 플래그를 포함해야 합니다. 이 플래그는 쉼표로 구분된 프로젝트 ID 목록으로 설정됩니다(예: project-1,project-2). 조직 내에서 최대 100개의 프로젝트를 지정할 수 있습니다. 이 목록에 프로젝트 ID를 포함하지 마세요. 기본적으로 예약된 용량을 사용할 수 있습니다.

• START_TIME: 요청의 시작 시간으로, RFC 3339 타임스탬프로 형식이 지정됩니다.

• END_TIME: 예약 기간의 종료 시간으로, RFC 3339 타임스탬프 형식입니다. 종료 시간 대신 예약 기간을 초 단위로 지정하려면 --end-time 플래그를 --duration 플래그로 바꿉니다.

• ZONE: 리소스를 예약하려는 영역

REST

캘린더 모드에서 미래용 예약 요청을 만들어 검토를 위해 제출하려면 베타 futureReservations.insert 메서드에 다음 POST 요청을 전송합니다. 예약하려는 리소스에 따라 요청 본문에 다음 필드를 포함합니다.

• GPU VM을 예약하려면 totalCount 및 machineType 필드를 포함합니다.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "deploymentType": "DENSE",
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "specificSkuProperties": {
      "totalCount": NUMBER_OF_VMS,
      "instanceProperties": {
        "machineType": "MACHINE_TYPE"
      }
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

• TPU를 예약하려면 acceleratorCount 및 vmFamily 필드를 포함합니다.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "deploymentType": "DENSE",
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "aggregateReservation": {
      "reservedResources": [
        {
          "accelerator": {
            "acceleratorCount": NUMBER_OF_CHIPS
          }
        }
      ],
      "vmFamily": "TPU_VERSION"
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

다음을 바꿉니다.

• PROJECT_ID: 요청을 만들려는 프로젝트의 ID입니다.

• ZONE: 리소스를 예약하려는 영역

• FUTURE_RESERVATION_NAME: 요청의 이름입니다.

• RESERVATION_NAME: Compute Engine에서 요청된 용량을 프로비저닝하기 위해 자동으로 생성하는 예약의 이름입니다.

• SHARE_TYPE: 조직의 다른 프로젝트에서 예약된 용량을 사용할 수 있는지 여부입니다. 다음 값 중 하나를 지정합니다.

  • 프로젝트 내에서만 용량을 사용하려면 다음을 실행하세요. LOCAL

  • 다른 프로젝트와 용량을 공유하려면 다음 단계를 따르세요. SPECIFIC_PROJECTS

  SPECIFIC_PROJECTS를 지정하는 경우 shareSettings 필드에 projectMap 필드를 포함하여 용량을 공유할 프로젝트를 지정해야 합니다. 조직 내에서 최대 100개의 프로젝트를 지정할 수 있습니다. 프로젝트 ID를 지정하지 마세요. 기본적으로 예약된 용량을 사용할 수 있습니다.

  예를 들어 요청된 용량을 다른 두 프로젝트와 공유하려면 다음을 포함합니다.

  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
  

  CONSUMER_PROJECT_ID_1 및 CONSUMER_PROJECT_ID_2을 요청된 용량을 사용할 수 있도록 허용할 두 프로젝트의 ID로 바꿉니다.

• NUMBER_OF_VMS: 예약할 GPU VM 수

• MACHINE_TYPE: 예약할 GPU 머신 유형입니다.

• NUMBER_OF_CHIPS: 예약할 TPU 칩 수입니다.

• TPU_VERSION: 예약할 TPU 버전입니다. 다음 값 중 하나를 지정합니다.

  • TPU v6e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

  • TPU v5p: VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

  • TPU v5e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

  TPU v5e를 지정하는 경우 aggregateResources 필드에 workloadType 필드를 포함해야 합니다. TPU에서 실행할 워크로드 유형으로 필드를 설정합니다.

  • ML 학습 워크로드와 같이 단일 또는 여러 작업에서 대량의 데이터를 처리하는 워크로드의 경우 BATCH를 지정합니다.

  • 동시 요청을 처리하고 최소한의 네트워크 지연 시간이 필요한 워크로드(예: ML 추론 워크로드)의 경우 SERVING를 지정합니다.

• START_TIME: 요청의 시작 시간으로, RFC 3339 타임스탬프로 형식이 지정됩니다.

• END_TIME: 예약 기간의 종료 시간으로, RFC 3339 타임스탬프 형식입니다. 종료 시간 대신 예약 기간을 초 단위로 지정하려면 endTime 필드를 duration 필드로 대체합니다.