예약 보기

이 문서에서는 예약을 보는 방법을 설명합니다.

예약 보기는 프로젝트의 모든 예약을 간략히 확인하거나 예약의 구성 세부정보를 검토하는 데 유용합니다. 공유 예약을 보려면 소유자 프로젝트를 사용해야만 볼 수 있습니다.

시작하기 전에

아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

필요한 역할

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

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

필수 권한

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

예약 목록 보기: 프로젝트에 대한 compute.reservations.list 권한
예약의 세부정보 보기: 프로젝트에 대한 compute.reservations.get 권한

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

예약 보기

예약에서 보려는 세부정보에 따라 다음 방법 중 하나를 선택합니다.

프로젝트의 모든 예약 개요를 보려면 예약 목록을 확인합니다.
공유된 예약이 공유되는 소비자 프로젝트 등 예약의 구성 세부정보를 보려면 예약 세부정보를 확인합니다.

예약 목록 보기

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

콘솔

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

예약으로 이동

온디맨드 예약 탭(기본값)에서 각 행은 예약을 설명하고 각 열은 속성을 설명합니다. 예를 들어 사용된 머신 열은 각 예약의 사용률 및 총 용량을 설명합니다. 25 (50) 값은 VM 50개에 대한 예약이 있고 그중 VM 25개가 소비되었음을 나타냅니다.

선택사항: 표시되는 예약 및 속성을 수정하려면 각각 필터 및 열 표시 옵션을 사용합니다.

gcloud

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

gcloud compute reservations list

출력은 다음 예시와 비슷하게 표시됩니다.

NAME: r-01
IN_USE_COUNT: 0
COUNT: 5
ZONE: us-central1-a
SHARE_TYPE: LOCAL

NAME: r-02
IN_USE_COUNT: 3
COUNT: 10
ZONE: us-central1-f
SHARE_TYPE: LOCAL

선택적으로 필터 표현식을 사용하여 예약 목록 범위를 좁히려면 --filter 플래그를 포함합니다.

gcloud compute reservations list \
    --filter="FILTER_EXPRESSION"

FILTER_EXPRESSION을 필터 표현식으로 바꿉니다.

예를 들어 이름이 prefix로 시작하고 us-central1-a 영역에 있는 예약만 보려면 다음 명령어를 실행합니다.

gcloud compute reservations list \
    --filter="name~prefix AND zone=us-central1-a"

REST

예약 목록을 보려면 GET 요청을 reservations.list 메서드로 전송합니다.

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

다음을 바꿉니다.

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

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

{
  "id": "4100668622331754141",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-05",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a",
  "name": "reservation-05",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "minCpuPlatform": "Any CPU Platform",
    },
    "count": "100",
    "inUseCount": "0"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation"
},
{
  "id": "2533514314332214789",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a",
  "name": "reservation-04",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-tesla-t4",
          "acceleratorCount": 1
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation"
}

원하는 경우 필터 표현식을 사용하여 예약 목록 범위를 좁히려면 다음과 같이 filter 쿼리 매개변수를 포함합니다.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION

다음을 바꿉니다.

PROJECT_ID: 예약이 있는 프로젝트의 ID입니다.
ZONE: 예약이 있는 영역입니다.
FILTER_EXPRESSION: 필터 표현식입니다.

예를 들어 prefix로 시작하고 us-central1-a 영역에 있는 이름의 예약만 보려면 URL로 인코딩된 값을 사용하여 다음 GET 요청을 수행합니다.

GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a

예약 세부정보 보기

각 지원되는 Google Cloud 제품이 예약에서 사용하는 VM 수를 확인하려면 Google Cloud 콘솔을 사용하여 예약 세부정보를 확인하세요.

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

콘솔

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

예약으로 이동
온디맨드 예약 탭(기본값)의 이름 열에서 세부정보를 보려는 예약의 이름을 클릭합니다.

예약의 세부정보 페이지가 열립니다. 사용률 섹션에서 지원되는 각 Google Cloud 제품의 예약을 사용하는 VM 수를 확인할 수 있습니다.

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

다음을 바꿉니다.

RESERVATION_NAME: 기존 예약의 이름
ZONE: 예약이 있는 영역

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

kind: compute#reservation
name: reservation-04
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04
specificReservation:
  count: '50'
  inUseCount: '25'
  instanceProperties:
    guestAccelerators:
    - acceleratorCount: 1
      acceleratorType: nvidia-tesla-t4
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-2
    minCpuPlatform: Any CPU Platform
specificReservationRequired: false
status: READY
zone: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a

예약 사용률을 확인하려면 count 및 inUseCount 필드를 참조하세요. 이 예시에서는 50개의 VM이 예약되고 25개의 VM이 사용됩니다.

REST

예약 세부정보를 보려면 GET 요청을 reservations.get 메서드로 전송합니다.

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

다음을 바꿉니다.

PROJECT_ID: 예약이 있는 프로젝트의 ID
ZONE: 예약이 있는 영역
RESERVATION_NAME: 기존 예약 이름

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

{
  "id": "2533514314332214789",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-centra1-a",
  "name": "reservation-04",
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-tesla-t4",
          "acceleratorCount": 1
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  }
}

예약 사용률을 확인하려면 count 및 inUseCount 필드를 참조하세요. 이 예시에서는 50개의 VM이 예약되고 25개의 VM이 사용됩니다.

다음 단계

예약을 약정에 연결하는 방법 알아보기
예약 사용 방법 알아보기
예약 수정 방법 알아보기
예약 삭제 방법 알아보기

예약 보기

시작하기 전에

Console

gcloud

REST

필요한 역할

필수 권한

예약 보기

예약 목록 보기

콘솔

gcloud

REST

예약 세부정보 보기

콘솔

gcloud

REST

다음 단계