예약된 용량 보기

이 문서에서는 예약된 용량 요청과 AI 하이퍼컴퓨터의 예약된 용량을 확인하는 방법을 설명합니다. 예약된 용량과 요청의 가용성, 속성, 토폴로지를 확인하여 워크로드의 예약된 용량을 계획할 수 있습니다.

이 문서의 범위는 미래용 예약이 언급된 용량 옵션을 사용하는 워크로드로 제한됩니다. AI 하이퍼컴퓨터의 용량 옵션에 대한 자세한 내용은 용량 개요를 참고하세요.

Google Cloud 가 미래용 예약 요청을 승인하면 Compute Engine이 요청된 리소스에 대해 빈 예약을 자동으로 만듭니다 (자동 생성). 그런 다음 예약을 확인하여 워크로드를 계획할 수 있습니다. 나중에 요청된 시작 시간에 다음이 발생합니다.

• Compute Engine은 예약된 가상 머신 (VM) 인스턴스를 예약에 추가합니다. 그런 다음 예약과 일치하는 VM을 만들어 예약을 사용할 수 있습니다.
• Vertex AI 학습 또는 예측 작업에서 예약을 사용할 수 있도록 수정할 수 있습니다. 자세한 내용은 예약의 공유 정책 수정을 참고하세요.

제한사항

Google에서 만든 프로젝트에서만 공유 예약 또는 공유 미래용 예약 요청을 볼 수 있습니다.

시작하기 전에

1. 용량 예약: 아직 프로젝트에서 AI 하이퍼컴퓨터의 용량을 예약하지 않은 경우 다음 옵션 중 하나를 사용하여 용량을 예약합니다.
   • 계정팀을 통해 용량 예약
   • 캘린더 모드에서 미래용 예약 요청 만들기

2. 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

   In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

   REST

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

   Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.

   gcloud init

   외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

   자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

   필요한 역할

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

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

   필수 권한

   예약을 보려면 다음 권한이 필요합니다.

   • 미래용 예약 요청의 세부정보를 보려면 프로젝트에 대한 compute.futureReservations.get 권한이 필요합니다.
   • 예약의 세부정보 보기: 프로젝트에 대한 compute.reservations.get 권한

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

   예약된 용량 요청 보기

   미래용 예약 요청을 보려면 다음 방법 중 하나 이상을 사용하세요.

   • 프로젝트의 모든 미래용 예약 요청을 개략적으로 확인하려면 미래용 예약 요청 목록을 확인하세요.
   • 단일 미래용 예약 요청의 전체 세부정보를 보려면 미래용 예약 요청의 세부정보를 봅니다.

   미래용 예약 요청 목록 보기

   미래용 예약 요청 목록을 확인하여 요청의 예약 기간, 상태, 영역을 확인할 수 있습니다.

   미래용 예약 요청 목록을 보려면 다음 옵션 중 하나를 선택합니다.

   콘솔

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

      예약으로 이동

   2. 미래용 예약 탭을 클릭합니다. 표에 각 미래용 예약 요청이 나열되고 각 테이블 열에 속성 설명이 표시됩니다.
   3. 선택사항: 요청 목록을 미세 조정하려면 필터 필드에서 요청을 필터링하려는 속성을 선택합니다.

   gcloud

   미래용 예약 요청 목록을 보려면 gcloud compute future-reservations list 명령어를 사용합니다.

   gcloud compute future-reservations list
   

   출력은 다음 예시와 비슷합니다.

   NAME: fr-01
   TOTAL_COUNT: 100
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-08-05T07:00:00Z
   PROCUREMENT_STATUS: FULFILLED
   ZONE: us-west4-b
   
   NAME: fr-02
   TOTAL_COUNT: 10
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-12-01T00:00:00Z
   PROCUREMENT_STATUS: PENDING_APPROVAL
   ZONE: us-west4-b
   

   미래용 예약 요청 목록을 미세 조정하려면 --filter 플래그와 함께 동일한 명령어를 사용합니다.

   REST

   미래용 예약 요청 목록을 보려면 다음 메서드 중 하나에 GET 요청을 수행합니다.

   • 모든 영역의 요청 목록을 보려면 futureReservations.aggregatedList 메서드를 사용하세요.
   • 특정 영역의 요청 목록을 보려면 다음을 실행하세요. futureReservations.list 메서드

   예를 들어 모든 영역의 요청 목록을 보려면 다음과 같이 GET 요청을 실행합니다.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/futureReservations
   

   PROJECT_ID를 요청이 있는 프로젝트의 ID로 바꿉니다.

   단일 영역의 미래용 예약 요청 목록 출력은 다음과 비슷합니다.

   {
     "id": "projects/example-project/aggregated/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       },
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/aggregated/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   미래용 예약 요청 목록을 미세 조정하려면 동일한 요청을 수행하고 요청 URL에 filter 쿼리 매개변수를 포함합니다.

   미래용 예약 요청 세부정보 보기

   미래용 예약 요청의 세부정보를 확인하여 예약된 리소스의 속성과 예약 기간을 검토할 수 있습니다.

   미래용 예약 요청의 세부정보를 보려면 다음 옵션 중 하나를 선택합니다.

   콘솔

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

      예약으로 이동

   2. 미래용 예약 탭을 클릭합니다. 표에 각 미래용 예약 요청이 나열되고 각 테이블 열에 속성 설명이 표시됩니다.
   3. 요청의 세부정보를 보려면 이름 열에서 요청의 이름을 클릭합니다. 미래용 예약 요청에 대한 세부정보가 포함된 페이지가 열립니다.

   gcloud

   미래용 예약 요청의 세부정보를 보려면 gcloud compute future-reservations describe 명령어를 사용합니다.

   gcloud compute future-reservations describe FUTURE_RESERVATION_NAME \
       --zone=ZONE
   

   다음을 바꿉니다.

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

   출력은 다음 예시와 비슷합니다.

   autoCreatedReservationsDeleteTime: '2026-02-10T19:20:00Z'
   creationTimestamp: '2025-11-27T11:14:58.305-08:00'
   deploymentType: DENSE
   id: '7979651787097007552'
   kind: compute#futureReservation
   name: example-draft-request
   planningStatus: DRAFT
   reservationName: example-reservation
   schedulingType: INDEPENDENT
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552
   specificReservationRequired: true
   specificSkuProperties:
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 8
         acceleratorType: nvidia-h200-141gb
       localSsds:
       -   diskSizeGb: '375'
         interface: NVME
       ...
     machineType: a3-ultragpu-8g
   totalCount: '2'
   status:
     autoCreatedReservations:
     -   https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/reservations/example-reservation
     fulfilledCount: '2'
     lockTime: '2026-01-27T19:15:00Z'
     procurementStatus: DRAFTING
   timeWindow:
     endTime: '2026-02-10T19:20:00Z'
     startTime: '2026-01-27T19:20:00Z'
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b
   

   REST

   미래용 예약 요청의 세부정보를 보려면 futureReservations.get 메서드에 GET 요청을 수행합니다.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
   

   다음을 바꿉니다.

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

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

   {
     "specificSkuProperties": {
       "instanceProperties": {
         "machineType": "a3-ultragpu-8g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-h200-141gb",
             "acceleratorCount": 8
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "375",
             "interface": "NVME"
           },
           ...
         ]
       },
       "totalCount": "2"
     },
     "kind": "compute#futureReservation",
     "id": "7979651787097007552",
     "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
     "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
     "name": "example-draft-request",
     "timeWindow": {
       "startTime": "2026-01-27T19:20:00Z",
       "endTime": "2026-02-10T19:20:00Z"
     },
     "status": {
       "procurementStatus": "DRAFTING",
       "lockTime": "2026-01-27T19:15:00Z"
     },
     "planningStatus": "DRAFT",
     "specificReservationRequired": true,
     "reservationName": "example-reservation",
     "deploymentType": "DENSE",
     "schedulingType": "INDEPENDENT",
     "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
   }
   

   예약된 용량 보기

   다음 중 하나 이상을 수행하려면 예약된 용량을 확인하세요.

   • 워크로드를 배포하는 데 사용할 예약, 블록, 하위 블록을 식별합니다.
   • 예약된 용량의 속성, 사용량, 토폴로지를 파악합니다.

   예약된 용량을 보려면 다음 방법 중 하나 이상을 사용하세요.

   • 프로젝트의 모든 예약 용량의 개요를 확인하고 사용되지 않은 예약 용량이 있는지 확인하려면 예약 목록을 확인하세요.
   • 예약의 모든 예약 VM의 속성과 가용성을 검토하려면 예약 세부정보를 확인하세요.
   • 예약의 용량 블록 및 하위 블록이 스케줄러 또는 계획 도구와의 통합과 같은 용도로 어떻게 구성되는지 알아보려면 예약의 토폴로지를 확인하세요.

   예약 목록 보기

   프로젝트의 예약 목록을 확인하여 프로젝트의 모든 예약된 용량을 확인하고 워크로드를 배포하는 데 사용할 예약을 검색할 수 있습니다.

   예약 목록을 보려면 다음 옵션 중 하나를 선택합니다.

   콘솔

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

      예약으로 이동

      온디맨드 예약 탭(기본값)에서 테이블에 각 예약이 나열되고, 각 테이블 열에 속성 설명이 표시됩니다.

   2. 선택사항: 예약 목록을 미세 조정하려면 필터 필드에서 예약을 필터링하려는 속성을 선택합니다.

   gcloud

   예약 목록을 보려면 gcloud compute reservations list 명령어를 사용합니다.

   gcloud compute reservations list
   

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

   NAME: r-01
   IN_USE_COUNT: 0
   COUNT: 5
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   
   NAME: r-02
   IN_USE_COUNT: 3
   COUNT: 10
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   

   예약 목록을 세부적으로 조정하려면 --filter 플래그와 함께 동일한 명령어를 사용합니다.

   REST

   예약 목록을 보려면 다음 메서드 중 하나에 GET 요청을 수행합니다.

   • 모든 영역의 예약 목록을 보려면 다음을 사용하세요. reservations.aggregatedList 메서드
   • 단일 영역에서 예약 목록을 보려면 reservations.list 메서드를 사용하세요.

   예를 들어 모든 영역의 예약 목록을 보려면 다음과 같이 GET 요청을 실행합니다.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations
   

   PROJECT_ID를 예약이 있는 프로젝트의 ID로 바꿉니다.

   단일 영역의 예약 목록 출력은 다음과 비슷합니다.

   {
     "id": "projects/example-project/zones/europe-west1-b/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       }
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   예약 목록을 미세 조정하려면 동일한 요청을 수행하고 요청 URL에 filter 쿼리 매개변수를 포함합니다.

   예약 세부정보 보기

   프로젝트의 예약 세부정보를 확인하여 다음과 같은 세부정보를 파악할 수 있습니다.

   • 예약에 포함된 VM 유형입니다.
   • 예약에서 예약되고 사용 가능한 VM 수입니다.
   • 정상 블록 수를 포함한 예약의 상태입니다. (gcloud CLI 또는 REST를 사용해야 함)

   예약의 블록과 하위 블록을 이해하려면 대신 예약의 토폴로지 보기를 참고하세요.

   예약 세부정보를 보려면 다음 옵션 중 하나를 선택합니다.

   콘솔

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

      예약으로 이동

   2. 온디맨드 예약 표의 이름 열에서 세부정보를 보려는 예약의 이름을 클릭합니다. 예약 세부정보를 제공하는 페이지가 표시됩니다.

   gcloud

   예약 세부정보를 보려면 gcloud compute reservations describe 명령어를 사용합니다.

   gcloud compute reservations describe RESERVATION_NAME \
       --zone=ZONE
   

   다음을 바꿉니다.

   • RESERVATION_NAME: 예약 이름.
   • ZONE: 예약이 있는 영역입니다.

   출력은 다음 예시와 비슷합니다.

   advancedDeploymentControl:
     reservationOperationalMode: ALL_CAPACITY
   creationTimestamp: '2025-07-18T13:23:22.191-07:00'
   deleteAtTime: '2026-06-19T00:00:00Z'
   deploymentType: DENSE
   enableEmergentMaintenance: false
   id: '4298354039694234582'
   kind: compute#reservation
   name: example-res1
   reservationSharingPolicy:
     serviceShareType: DISALLOW_ALL
   resourceStatus:
     healthInfo:
       degradedBlockCount: 0
       healthStatus: HEALTHY
       healthyBlockCount: 1
     reservationBlockCount: 1
     reservationMaintenance:
       schedulingType: GROUPED
   schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/4298354039694234582
   shareSettings:
     shareType: LOCAL
   specificReservation:
     assuredCount: '18'
     count: '18'
     inUseCount: '2'
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 4
         acceleratorType: nvidia-gb200
       localSsds:
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       machineType: a4x-highgpu-4g
   specificReservationRequired: true
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   출력에는 예약에 관한 다음 필드가 포함됩니다.

   • name: 예약 이름.
   • healthInfo: 예약의 건강 정보입니다. 다음을 참고하세요.
     • degradedBlockCount: 예약에서 저하된 블록 수입니다.
     • healthStatus: 예약의 전반적인 상태입니다.
     • healthyBlockCount: 예약의 정상 블록 수입니다.
   • reservationBlockCount: 예약의 총 블록 수입니다.
   • assuredCount: 예약을 사용하여 배포할 수 있는 총 VM 수입니다. 이 값이 count보다 작으면 소비에 사용 가능한 더 적은 수의 VM 문제 해결 방법을 참고하세요.
   • inUseCount: 예약에 이미 배포된 VM 수입니다.
   • instanceProperties: 예약을 배포할 수 있는 VM의 속성입니다.

   REST

   예약 세부정보를 보려면 reservations.get 메서드에 GET 요청을 수행합니다.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
   

   다음을 바꿉니다.

   • PROJECT_ID: 예약이 있는 프로젝트의 ID
   • ZONE: 예약이 있는 영역입니다.
   • RESERVATION_NAME: 예약 이름.

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

   {
     "specificReservation": {
       "instanceProperties": {
         "machineType": "a4x-highgpu-4g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-gb200",
             "acceleratorCount": 4
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           }
         ]
       },
       "count": "36",
       "inUseCount": "35",
       "assuredCount": "33"
     },
     "kind": "compute#reservation",
     "id": "6823689647457870910",
     "creationTimestamp": "2025-08-04T13:40:50.496-07:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
     "name": "example-res1",
     "specificReservationRequired": true,
     "status": "READY",
     "shareSettings": {
       "shareType": "SPECIFIC_PROJECTS"
     },
     "resourceStatus": {
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "maintenanceStatus": "ONGOING"
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "reservationBlockCount": 1,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyBlockCount": 0,
         "degradedBlockCount": 1
       }
     },
     "reservationSharingPolicy": {
       "serviceShareType": "DISALLOW_ALL"
     },
     "deploymentType": "DENSE",
     "advancedDeploymentControl": {
       "reservationOperationalMode": "ALL_CAPACITY"
     },
     "enableEmergentMaintenance": false,
     "schedulingType": "GROUPED",
     "deleteAtTime": "2025-10-01T00:00:00Z"
   }
   

   출력에는 예약에 관한 다음 필드가 포함됩니다.

   • instanceProperties: 예약을 배포할 수 있는 VM의 속성입니다.
   • inUseCount: 예약에 이미 배포된 VM 수입니다.
   • assuredCount: 예약을 사용하여 배포할 수 있는 총 VM 수입니다. 이 값이 count보다 작으면 소비에 사용 가능한 더 적은 수의 VM 문제 해결 방법을 참고하세요.
   • name: 예약 이름.
   • healthInfo: 예약의 건강 정보입니다. 다음을 참고하세요.
     • healthStatus: 예약의 전반적인 상태입니다.
     • healthyBlockCount: 예약의 정상 블록 수입니다.
     • degradedBlockCount: 예약에서 저하된 블록 수입니다.

   예약의 토폴로지 보기

   예약된 블록 및 하위 블록 내에서 VM을 만들 위치를 결정하는 데 도움이 되도록 예약의 자세한 토폴로지 정보를 볼 수 있습니다. 이미 배포된 예약 VM의 배치에 대한 자세한 내용은 컴퓨팅 인스턴스의 토폴로지 보기를 참고하세요.

   예약에 관한 다른 세부정보를 보려면 예약 세부정보 보기를 참고하세요.

   예약된 블록 보기

   예약에서 사용 가능한 블록을 나열하고 설명하려면 다음 방법 중 하나를 사용하세요. 이 작업을 통해 다음을 확인할 수 있습니다.

   • 예약에 포함된 용량 블록입니다.
   • 각 블록에서 사용 가능한 용량입니다.
   • 정상 하위 블록 수를 포함한 각 블록의 상태입니다. (gcloud CLI 또는 REST를 사용해야 함)
   • 블록에 배포된 모든 VM의 이름, 블록, 하위 블록입니다. (gcloud CLI 또는 REST를 사용하여 특정 블록을 볼 때만 사용 가능)

   콘솔

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

      예약으로 이동

   2. 온디맨드 예약 표의 이름 열에서 세부정보를 보려는 예약의 이름을 클릭합니다. 예약의 세부정보 페이지가 열립니다.
   3. 리소스 토폴로지 섹션에서 예약된 블록에 관한 정보를 볼 수 있습니다. 이 정보에는 각 블록에 대한 다음이 포함됩니다.
      • 차단 ID: 차단의 이름입니다.
      • 개수: 블록에 배포할 수 있는 총 VM 수입니다.
      • 사용 중: 블록에 이미 배포된 VM 수입니다.

   gcloud

   다음 명령어를 사용하여 예약의 차단 항목을 확인할 수 있습니다.

   • 예약에서 사용 가능한 모든 블록을 보려면 gcloud compute reservations blocks list 명령어를 사용합니다.

     gcloud compute reservations blocks list RESERVATION_NAME \
         --zone=ZONE
     

   • 예약에서 특정 블록을 보려면 gcloud compute reservations blocks describe 명령어를 사용합니다. 블록에 배포된 모든 VM의 이름과 토폴로지를 확인하려면 --full-view=BLOCK_VIEW_FULL 플래그를 추가합니다.

     gcloud compute reservations blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --full-view=BLOCK_VIEW_FULL
     

   다음을 바꿉니다.

   • RESERVATION_NAME: 예약 이름.
   • ZONE: 예약이 있는 영역입니다.
   • BLOCK_NAME: 블록의 이름입니다.

   각 블록의 출력은 다음 예시와 비슷합니다.

   resource:
     count: 36
     creationTimestamp: '2025-08-04T15:15:07.074-07:00'
     healthInfo:
       degradedSubBlockCount: 2
       healthStatus: DEGRADED
       healthySubBlockCount: 0
     id: '4360924059555106309'
     inUseCount: 35
     kind: compute#reservationBlock
     name: example-res1-block-0001
     physicalTopology:
       block: 1acd074d42cd3be9e4486b524db2e9ab
       cluster: us-central1-cluster-dnkc
       instances:
       -   instanceId: '5815586279631866288'
         physicalHostTopology:
           host: c229b308380a83e0ca345d4a0de05aa7
           subBlock: c02af6bdaeccacef571e0adbe79e8c28
         projectId: 'PROJECT_NUMBER'
       ...
       -   instanceId: '8389759878923049076'
         physicalHostTopology:
           host: '3ac534f00c20e6e0c87c3aaff2705be6'
           subBlock: 'c081876ba0aa2857d608eb30a5b2fa40'
         projectId: 'PROJECT_NUMBER'
     reservationMaintenance:
       instanceMaintenanceOngoingCount: 3
       instanceMaintenancePendingCount: 32
       maintenanceOngoingCount: 2
       maintenancePendingCount: 34
       schedulingType: GROUPED
       subblockInfraMaintenanceOngoingCount: 0
       subblockInfraMaintenancePendingCount: 0
       upcomingGroupMaintenance:
         canReschedule: false
         maintenanceReasons:
         -   PLANNED_UPDATE
         maintenanceStatus: ONGOING
         type: SCHEDULED
         windowEndTime: '2025-09-08T17:00:00.000-07:00'
         windowStartTime: '2025-09-08T13:00:00.000-07:00'
     reservationSubBlockCount: 2
     reservationSubBlockInUseCount: 2
     selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001
     selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309
     status: READY
     zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   출력에는 각 블록에 대한 다음 필드가 포함됩니다.

   • count: 블록에 배포할 수 있는 총 VM 수입니다.
   • healthInfo: 블록의 상태 정보는 다음과 같습니다.
     • degradedSubBlockCount: 블록의 성능 저하된 하위 블록 수입니다.
     • healthStatus: 블록의 전반적인 상태입니다.
     • healthySubBlockCount: 블록의 정상 하위 블록 수입니다.
   • inUseCount: 블록에 이미 배포된 VM 수입니다.
   • name: 블록의 이름입니다.
   • physicalTopology: 블록의 실제 위치입니다. VM 토폴로지에도 다음과 같이 표시됩니다.
     • block: 블록의 조직별 ID입니다.
     • cluster: 클러스터의 전역 이름입니다.
     • instances: 블록에 있는 모든 VM의 이름과 실제 위치 목록입니다. (이 필드는 --full-view=BLOCK_VIEW_FULL 플래그를 포함하는 경우에만 표시됩니다.)
       • instanceId: 인스턴스의 ID입니다.
       • subBlock: 이 인스턴스가 있는 하위 블록의 조직별 ID입니다.
       • block: 이 인스턴스가 있는 블록의 조직별 ID입니다.
   • reservationSubBlockCount: 블록의 하위 블록 수입니다.
   • reservationSubBlockInUseCount: 이미 하나 이상의 VM이 배포된 블록의 하위 블록 수입니다.

   REST

   다음 방법을 사용하여 예약의 차단 항목을 볼 수 있습니다.

   • 예약에서 사용 가능한 블록을 모두 보려면 reservationBlocks.list 메서드에 GET 요청을 실행합니다.

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
     

   • 예약에서 특정 차단 목록을 보려면 reservationBlocks.get 메서드에 GET 요청을 실행합니다. 블록에 배포된 모든 VM의 이름과 토폴로지를 함께 보려면 ?view=FULL 쿼리 매개변수를 추가합니다.

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL
     

   다음을 바꿉니다.

   • PROJECT_ID: 예약이 있는 프로젝트의 ID입니다.
   • ZONE: 예약이 있는 영역입니다.
   • RESERVATION_NAME: 예약 이름.
   • BLOCK_NAME: 블록의 이름입니다.

   각 블록의 출력은 다음과 비슷합니다.

   {
     "resource": {
       "kind": "compute#reservationBlock",
       "id": "4360924059555106309",
       "creationTimestamp": "2025-08-04T15:15:07.074-07:00",
       "name": "example-res1-block-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309",
       "count": 36,
       "inUseCount": 35,
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "instances": [
           {
             "instanceId": "5815586279631866288",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c02af6bdaeccacef571e0adbe79e8c28",
               "host": "c229b308380a83e0ca345d4a0de05aa7"
             }
           },
           ...
           {
             "instanceId": "8389759878923049076",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c081876ba0aa2857d608eb30a5b2fa40",
               "host": "3ac534f00c20e6e0c87c3aaff2705be6"
             }
           }
         ]
       },
       "reservationSubBlockCount": 2,
       "reservationSubBlockInUseCount": 2,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthySubBlockCount": 0,
         "degradedSubBlockCount": 2
       }
     }
   }
   

   출력에는 각 블록에 대한 다음 필드가 포함됩니다.

   • name: 블록의 이름입니다.
   • count: 블록에 배포할 수 있는 총 VM 수입니다.
   • inUseCount: 블록에 이미 배포된 VM 수입니다.
   • physicalTopology: 블록의 실제 위치입니다. VM 토폴로지에도 다음과 같이 표시됩니다.
     • cluster: 클러스터의 전역 이름입니다.
     • block: 블록의 조직별 ID입니다.
     • instances: 블록에 있는 모든 VM의 이름과 실제 위치 목록입니다. (이 필드는 ?view=FULL 쿼리 매개변수를 포함하는 경우에만 표시됩니다.)
       • instanceId: 인스턴스의 ID입니다.
       • subBlock: 이 인스턴스가 있는 하위 블록의 조직별 ID입니다.
       • block: 이 인스턴스가 있는 블록의 조직별 ID입니다.
   • reservationSubBlockCount: 블록의 하위 블록 수입니다.
   • reservationSubBlockInUseCount: 이미 하나 이상의 VM이 배포된 블록의 하위 블록 수입니다.
   • healthInfo: 블록의 상태 정보는 다음과 같습니다.
     • healthStatus: 블록의 전반적인 상태입니다.
     • healthySubBlockCount: 블록의 정상 하위 블록 수입니다.
     • degradedSubBlockCount: 블록의 성능 저하된 하위 블록 수입니다.

   예약된 하위 블록 보기

   예약 블록에서 사용 가능한 하위 블록을 나열하고 설명하려면 Google Cloud CLI 또는 REST API를 사용하세요. 이 작업을 통해 다음을 확인할 수 있습니다.

   • 예약된 블록에 있는 용량의 하위 블록입니다.
   • 각 하위 블록에서 사용할 수 있는 용량입니다.
   • 정상 호스트 머신 수와 정상 가속기 상호 연결 수를 비롯한 각 하위 블록의 상태입니다.

   gcloud

   다음 명령어를 사용하여 예약의 하위 블록을 확인할 수 있습니다.

   • 예약 블록에서 사용 가능한 모든 하위 블록을 보려면 gcloud compute reservations sub-blocks list 명령어를 사용합니다.

     gcloud compute reservations sub-blocks list RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME
     

   • 예약 블록의 특정 하위 블록을 보려면 gcloud compute reservations sub-blocks describe 명령어를 사용합니다.

     gcloud compute reservations sub-blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --sub-block-name=SUB-BLOCK_NAME
     

   다음을 바꿉니다.

   • RESERVATION_NAME: 예약 이름.
   • ZONE: 예약이 있는 영역입니다.
   • BLOCK_NAME: 블록의 이름입니다.
   • SUB-BLOCK_NAME: 하위 블록의 이름입니다.

   각 하위 블록의 출력은 다음과 비슷합니다.

   count: 18
   creationTimestamp: '2025-07-18T14:50:01.652-07:00'
   healthInfo:
     degradedHostCount: 0
     degradedInfraCount: 0
     healthStatus: HEALTHY
     healthyHostCount: 18
     healthyInfraCount: 1
   id: '6848013619223297894'
   inUseCount: 2
   kind: compute#reservationSubBlock
   name: example-res1-block-0001-subblock-0001
   physicalTopology:
     block: 2b6aa63faa2b60b7ecd3b87ec337f270
     cluster: us-central1-cluster-xvhj
     subBlock: 556a310b49a0b247bc109cc7f997cea2
   reservationSubBlockMaintenance:
     schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/6848013619223297894
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   출력에는 각 하위 블록에 대한 다음 필드가 포함됩니다.

   • count: 하위 블록에 배포할 수 있는 총 VM 수입니다.
   • healthInfo: 다음과 같은 하위 블록의 상태 정보입니다.
     • degradedHostCount: 하위 블록에서 성능이 저하된 호스트 머신 수입니다.
     • degradedInfraCount: 하위 블록에서 성능이 저하된 가속기 인터커넥트 수입니다.
     • healthStatus: 하위 블록의 전반적인 상태입니다.
     • healthyHostCount: 하위 블록의 정상 호스트 머신 수입니다.
     • healthyInfraCount: 하위 블록의 정상 가속기 상호 연결 수입니다.
   • inUseCount: 하위 블록에 이미 배포된 VM 수입니다.
   • name: 하위 블록의 이름입니다.
   • physicalTopology: 하위 블록의 실제 위치입니다. VM 토폴로지에도 다음과 같이 표시됩니다.
     • block: 블록의 조직별 ID입니다.
     • cluster: 클러스터의 전역 이름입니다.
     • subblock: 하위 블록의 조직별 ID입니다.

   REST

   다음 방법을 사용하여 예약의 하위 블록을 볼 수 있습니다.

   • 예약 블록에서 사용 가능한 하위 블록을 모두 보려면 reservationSubBlocks.list 메서드에 GET 요청을 실행합니다.

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
     

   • 예약 블록에서 특정 하위 블록을 보려면 reservationSubBlocks.get 메서드에 GET 요청을 실행합니다.

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME
     

   다음을 바꿉니다.

   • PROJECT_ID: 예약이 있는 프로젝트의 ID입니다.
   • ZONE: 예약이 있는 영역입니다.
   • RESERVATION_NAME: 예약 이름.
   • BLOCK_NAME: 블록의 이름입니다.
   • SUB-BLOCK_NAME: 하위 블록의 이름입니다.

   각 하위 블록의 출력은 다음과 비슷합니다.

   {
     "resource": {
       "kind": "compute#reservationSubBlock",
       "id": "5679680646666817028",
       "creationTimestamp": "2025-08-04T15:15:07.625-07:00",
       "name": "example-res1-block-0001-subblock-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/5679680646666817028",
       "count": 18,
       "inUseCount": 18,
       "reservationSubBlockMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 16,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 15
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "subBlock": "c081876ba0aa2857d608eb30a5b2fa40"
       },
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyHostCount": 16,
         "degradedHostCount": 2,
         "healthyInfraCount": 1,
         "degradedInfraCount": 0
       }
     }
   }
   

   출력에는 각 하위 블록에 대한 다음 필드가 포함됩니다.

   • name: 하위 블록의 이름입니다.
   • count: 하위 블록에 배포할 수 있는 총 VM 수입니다.
   • inUseCount: 하위 블록에 이미 배포된 VM 수입니다.
   • physicalTopology: 하위 블록의 실제 위치입니다. VM 토폴로지에도 다음과 같이 표시됩니다.
     • cluster: 클러스터의 전역 이름입니다.
     • block: 블록의 조직별 ID입니다.
     • subblock: 하위 블록의 조직별 ID입니다.
   • healthInfo: 다음과 같은 하위 블록의 상태 정보입니다.
     • healthStatus: 하위 블록의 전반적인 상태입니다.
     • healthyHostCount: 하위 블록의 정상 호스트 머신 수입니다.
     • degradedHostCount: 하위 블록에서 성능이 저하된 호스트 머신 수입니다.
     • healthyInfraCount: 하위 블록의 정상 가속기 상호 연결 수입니다.
     • degradedInfraCount: 하위 블록에서 성능이 저하된 가속기 인터커넥트 수입니다.

   다음 단계

   • VM 및 클러스터 생성 개요
   • 예약 사용량 보기
   의견 보내기