예약 보기


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

시작하기 전에

  • 예약에 대해서는 요구사항제한사항을 참조하세요.
  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 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
    2. Set a default region and zone.
    3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command:

        gcloud init

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

필요한 역할

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

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

필수 권한

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

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

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

예약 보기

현재 프로젝트에서 생성된 예약만 볼 수 있습니다.

소유자 프로젝트에서만 공유 예약을 볼 수 있습니다. 공유 예약이 공유된 프로젝트를 보려면 예약 세부정보를 확인합니다.

예약 목록 보기

예약 목록을 보려면 Google Cloud 콘솔, gcloud CLI, REST를 사용합니다.

콘솔

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

예약으로 이동

예약 페이지가 표시됩니다.

표에서 각 행은 예약을 설명하고 각 열은 속성을 설명합니다. 예를 들어 사용된 머신 열은 각 예약의 사용률 및 총 용량을 설명합니다. 25 (50) 값은 50개의 VM에 대한 예약을 나타내며, 이 가운데 VM 25개는 소비되었습니다.

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

gcloud

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

gcloud compute reservations list \
    --project=PROJECT_ID

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

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

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" \
    --project=PROJECT_ID

다음을 바꿉니다.

  • FILTER_EXPRESSION: 필터 표현식입니다.

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

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

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

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

선택적으로 필터 표현식을 사용하여 예약 목록의 범위를 좁히려면 다음 GET 요청을 수행합니다.

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 콘솔, gcloud CLI, REST를 사용합니다.

콘솔

예약 세부정보를 보려면 다음을 수행합니다.

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

    예약으로 이동

    예약 페이지가 표시됩니다.

  2. 이름 열에서 설명하려는 예약의 이름을 클릭합니다.

    예약의 세부정보 페이지가 표시됩니다. 예약 사용률을 확인하려면 예약된 총 머신 수사용한 머신 필드를 참조하세요.

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

다음을 바꿉니다.

  • RESERVATION_NAME: 기존 예약 이름

  • PROJECT_ID: 예약이 있는 프로젝트의 ID

  • 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

예약 사용률을 확인하려면 countinUseCount 필드를 참조하세요. 이 예시에서는 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"
  }
}

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

다음 단계