이 페이지는 Cloud Translation API를 통해 번역되었습니다.

예약된 용량 보기

이 문서에서는 H4D VM 및 향상된 관리 기능이 있는 HPC 클러스터의 예약된 용량과 예약된 용량 요청을 확인하는 방법을 설명합니다. 예약된 용량과 요청의 가용성, 속성, 토폴로지를 확인하여 워크로드의 예약된 용량을 계획할 수 있습니다.

이 문서의 범위는 미래용 예약이 언급된 용량 옵션을 사용하는 워크로드로 제한됩니다. H4D VM 및 향상된 관리 기능이 있는 HPC 클러스터의 용량 옵션에 대한 자세한 내용은 소비 옵션 선택 및 용량 확보를 참고하세요.

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

시작하기 전에

용량 예약: 아직 예약하지 않은 경우 다음 옵션 중 하나를 사용하여 H4D 인스턴스의 용량을 예약합니다.
- 계정팀을 통해 용량 예약
- 캘린더 모드에서 미래용 예약 요청 만들기
아직 인증을 설정하지 않았다면 설정합니다. 인증은 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. Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
  gcloud init
  외부 ID 프로바이더(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
  
  참고: 이전에 gcloud CLI를 설치했으면 gcloud components update를 실행하여 최신 버전이 설치되어 있는지 확인하세요.
2. Set a default region and zone.
REST

로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

필요한 역할

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

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

필수 권한

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

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

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

제한사항

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

예약된 용량 요청 보기

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

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

미래용 예약 요청 목록 보기

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

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

콘솔

Google Cloud 콘솔에서 예약 페이지로 이동합니다.
예약으로 이동
미래용 예약 탭을 클릭합니다. 표에 각 미래용 예약 요청이 나열되고 각 테이블 열에 속성이 설명되어 있습니다.
선택사항: 요청 목록을 미세 조정하려면 필터 필드에서 요청을 필터링하려는 속성을 선택합니다.

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": "h4d-standard-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "8"
      },
      "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/us-central1-a/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "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 쿼리 매개변수를 포함합니다.

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

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

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

콘솔

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

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

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": "h4d-standard-192"
    },
    "totalCount": "8"
  },
  "kind": "compute#futureReservation",
  "id": "7201773389437194422",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7201773389437194422",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "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": "GROUPED",
  "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
}

예약된 용량 보기

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

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

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

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

예약 목록 보기

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

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

콘솔

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

온디맨드 예약 탭(기본값)에서 테이블에 각 예약이 나열되고, 각 테이블 열에 속성 설명이 표시됩니다.
선택사항: 예약 목록을 미세 조정하려면 필터 필드에서 예약을 필터링하려는 속성을 선택합니다.

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-west4-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "h4d-highmem-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
        },
        "totalCount": "8"
      },
      "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-west4-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-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": "GROUPED",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

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

예약 세부정보 보기

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

예약에 포함된 VM 유형입니다.
예약에서 예약되고 사용 가능한 VM 수입니다.

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

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

콘솔

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

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

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

다음을 바꿉니다.

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

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

advancedDeploymentControl:
  reservationOperationalMode: HIGHLY_AVAILABLE_CAPACITY
creationTimestamp: '2025-11-20T15:49:02.541-07:00'
deleteAtTime: '2026-01-31T07:00:00Z'
deploymentType: DENSE
id: '5555834036379788721'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '8'
  count: '8'
  inUseCount: '0'
  instanceProperties:
    machineType: h4d-highmem-192
    minCpuPlatform: Any CPU Platform
specificReservationRequired: true
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

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

name: 예약 이름.
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": "h4d-highmem-192-lssd",
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        }
      ]
    },
    "count": "8",
    "inUseCount": "0",
    "assuredCount": "8"
  },
  "kind": "compute#reservation",
  "id": "5555834036379788721",
  "creationTimestamp": "2025-11-20T15:49:02.541-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": "LOCAL"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "schedulingType": "INDEPENDENT"
    },
    "reservationBlockCount": 1
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "HIGHLY_AVAILABLE_CAPACITY"
  },
  "schedulingType": "INDEPENDENT",
  "deleteAtTime": "2026-01-31T07:00:00Z"
}

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

instanceProperties: 예약을 배포할 수 있는 VM의 속성입니다.
inUseCount: 예약에 이미 배포된 VM 수입니다.
assuredCount: 예약을 사용하여 배포할 수 있는 총 VM 수입니다. 이 값이 count보다 작으면 소비에 사용 가능한 더 적은 수의 VM 문제 해결 방법을 참고하세요.
name: 예약 이름.

예약의 토폴로지 보기

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

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

예약된 블록 보기

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

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

콘솔

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

예약으로 이동
온디맨드 예약 표의 이름 열에서 세부정보를 보려는 예약의 이름을 클릭합니다. 예약의 세부정보 페이지가 열립니다.
리소스 토폴로지 섹션에서 예약된 블록에 관한 정보를 볼 수 있습니다. 이 정보에는 각 블록에 대한 다음이 포함됩니다.
- 블록 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'
  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 수입니다.
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
  }
}

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

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

예약된 하위 블록 보기

예약 블록에서 사용 가능한 하위 블록을 나열하고 설명하려면 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'
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 수입니다.
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"
    }
  }
}

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

name: 하위 블록의 이름입니다.
count: 하위 블록에 배포할 수 있는 총 VM 수입니다.
inUseCount: 하위 블록에 이미 배포된 VM 수입니다.
physicalTopology: 하위 블록의 실제 위치입니다. VM 토폴로지에도 다음과 같이 표시됩니다.
- cluster: 클러스터의 전역 이름입니다.
- block: 블록의 조직별 ID입니다.
- subblock: 하위 블록의 조직별 ID입니다.

다음 단계

HPC 클러스터 생성 개요에서 사용 가능한 모든 소비 옵션을 검토하세요.
Cloud RDMA를 사용하는 HPC 최적화 인스턴스 일괄 생성
H4D 인스턴스로 RDMA 지원 HPC Slurm 클러스터 만들기
예약에 바인딩된 소비로 HPC 워크로드용 MIG 만들기

예약된 용량 보기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

Console

gcloud

REST

필요한 역할

필수 권한

제한사항

예약된 용량 요청 보기

미래용 예약 요청 목록 보기

콘솔

gcloud

REST

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

콘솔

gcloud

REST

예약된 용량 보기

예약 목록 보기

콘솔

gcloud

REST

예약 세부정보 보기

콘솔

gcloud

REST

예약의 토폴로지 보기

예약된 블록 보기

콘솔

gcloud

REST

예약된 하위 블록 보기

gcloud

REST

다음 단계

예약된 용량 보기