이 문서에서는 예약을 보는 방법을 설명합니다.
시작하기 전에
- 예약에 대해서는 요구사항 및 제한사항을 참조하세요.
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
예약 목록 보기:
프로젝트에 대한
compute.reservations.list
권한 -
예약의 세부정보 보기:
프로젝트에 대한
compute.reservations.get
권한 FILTER_EXPRESSION
: 필터 표현식입니다.PROJECT_ID
: 예약이 있는 프로젝트의 ID입니다.PROJECT_ID
: 예약이 있는 프로젝트의 ID입니다.ZONE
: 예약이 있는 영역입니다.PROJECT_ID
: 예약이 있는 프로젝트의 ID입니다.ZONE
: 예약이 있는 영역입니다.FILTER_EXPRESSION
: 필터 표현식입니다.Google Cloud 콘솔에서 예약 페이지로 이동합니다.
예약 페이지가 표시됩니다.
이름 열에서 설명하려는 예약의 이름을 클릭합니다.
예약의 세부정보 페이지가 표시됩니다. 예약 사용률을 확인하려면 예약된 총 머신 수 및 사용한 머신 필드를 참조하세요.
RESERVATION_NAME
: 기존 예약 이름PROJECT_ID
: 예약이 있는 프로젝트의 IDZONE
: 예약이 있는 영역PROJECT_ID
: 예약이 있는 프로젝트의 IDZONE
: 예약이 있는 영역RESERVATION_NAME
: 기존 예약의 이름- 예약을 약정에 연결하는 방법 알아보기
- 예약 사용 방법 알아보기
- 예약 수정 방법 알아보기
- 예약 삭제 방법 알아보기
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 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.이 사전 정의된 역할에는 예약을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
예약을 보려면 다음 권한이 필요합니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
예약 보기
현재 프로젝트에서 생성된 예약만 볼 수 있습니다.
소유자 프로젝트에서만 공유 예약을 볼 수 있습니다. 공유 예약이 공유된 프로젝트를 보려면 예약 세부정보를 확인합니다.
예약 목록 보기
예약 목록을 보려면 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
다음을 바꿉니다.
예를 들어 이름이
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
다음을 바꿉니다.
출력은 다음 예시와 비슷합니다.
{ "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
다음을 바꿉니다.
예를 들어
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를 사용합니다.
콘솔
예약 세부정보를 보려면 다음을 수행합니다.
gcloud
예약 세부정보를 보려면
gcloud compute reservations describe
명령어를 사용합니다.gcloud compute reservations describe RESERVATION_NAME \ --project=PROJECT_ID \ --zone=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
다음을 바꿉니다.
출력은 다음 예시와 비슷하게 표시됩니다.
{ "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이 사용됩니다.다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-05(UTC)
-