이 문서에서는 예약을 보는 방법을 설명합니다.
예약을 확인하면 프로젝트의 모든 예약을 개략적으로 살펴보거나 예약의 구성 세부정보를 검토하는 데 유용합니다. 공유 예약을 보려면 소유자 프로젝트를 사용해야만 볼 수 있습니다.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Terraform
로컬 개발 환경에서 이 페이지의 Terraform 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
Go
로컬 개발 환경에서 이 페이지의 Go 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
Java
로컬 개발 환경에서 이 페이지의 Java 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
Node.js
로컬 개발 환경에서 이 페이지의 Node.js 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
Python
로컬 개발 환경에서 이 페이지의 Python 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
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 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"
예약 목록을 보려면 GET
요청을 reservations.list
메서드로 전송합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /reservations
다음을 바꿉니다.
PROJECT_ID
: 예약이 있는 프로젝트의 ID입니다.ZONE
: 예약이 있는 영역입니다.
출력은 다음 예시와 비슷합니다.
{
"kind": "compute#reservation",
"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"
},
"count": "100",
"inUseCount": "0",
"assuredCount": "100"
},
"specificReservationRequired": false,
"status": "READY",
"shareSettings": {
"shareType": "LOCAL"
}
},
{
"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
}
],
"localSsds": [
{
"diskSizeGb": "375",
"interface": "SCSI"
}
]
},
"count": "50",
"inUseCount": "25",
"assuredCount": "50"
},
"specificReservationRequired": false,
"status": "READY",
"shareSettings": {
"shareType": "LOCAL"
}
}
원하는 경우 필터 표현식을 사용하여 예약 목록 범위를 좁히려면 다음과 같이 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 콘솔을 사용하여 예약 세부정보를 확인하세요. 그렇지 않으면 다음 옵션 중 하나를 선택합니다.
예약 세부정보를 보려면 gcloud compute reservations describe
명령어를 사용합니다.
gcloud compute reservations describe RESERVATION_NAME \
--zone=ZONE
다음을 바꿉니다.
RESERVATION_NAME
: 기존 예약의 이름ZONE
: 예약이 있는 영역
출력은 다음과 비슷합니다.
creationTimestamp: '2024-10-11T03:25:23.192-07:00'
id: '4488228526648280060'
kind: compute#reservation
name: r-01
selfLink: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/r-01
shareSettings:
shareType: LOCAL
specificReservation:
assuredCount: '50'
count: '50'
inUseCount: '25'
instanceProperties:
machineType: n2-standard-2
specificReservationRequired: false
status: READY
zone: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a
예약 세부정보를 보려면 GET
요청을 reservations.get
메서드로 전송합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /reservations/RESERVATION_NAME
다음을 바꿉니다.
PROJECT_ID
: 예약이 있는 프로젝트의 IDZONE
: 예약이 있는 영역RESERVATION_NAME
: 기존 예약 이름
출력은 다음과 비슷합니다.
{
"kind": "compute#reservation",
"id": "4488228526648280060",
"creationTimestamp": "2024-10-11T03:25:23.192-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/davide-experimental/zones/us-central1-a/reservations/r-01",
"zone": "https://www.googleapis.com/compute/v1/projects/davide-experimental/zones/us-central1-a",
"name": "r-01",
"specificReservation": {
"instanceProperties": {
"machineType": "n2-standard-2"
},
"count": "50",
"inUseCount": "25",
"assuredCount": "50"
},
"specificReservationRequired": false,
"status": "READY",
"shareSettings": {
"shareType": "LOCAL"
}
}
사용 가능한 VM 수 확인
예약을 볼 때 다음 필드를 선택하여 예약을 사용하는 VM 수와 더 사용할 수 있는 VM 수를 확인할 수 있습니다.
보장된 수 (
assuredCount
): 프로젝트의 예약 영역과 공유 예약이 공유되는 모든 프로젝트에 실제로 예약된 VM 수입니다.총 개수 (
count
): 예약에 지정된 예약된 VM 수입니다. 이 숫자는 보장된 수와 일치해야 합니다.사용 중인 머신 (
inUseCount
): 예약을 사용하는 프로젝트 또는 공유 예약이 공유된 프로젝트에서 실행 중인 VM 수입니다.
예를 들어 보장된 수 (assuredCount
)와 총 수 (count
)가 모두 50이고 예약을 사용하는 VM 수 (inUseCount
)가 25이면 25대의 VM이 예약을 사용하고 있으며 예약이 완전히 사용되기 전에 25대의 VM을 더 만들고 실행할 수 있습니다.
다음 단계
예약을 약정에 연결하는 방법 알아보기
예약 사용 방법 알아보기
예약 수정 방법 알아보기
예약 삭제 방법 알아보기