이 문서에서는 미래용 예약 요청을 확인하는 방법을 설명합니다.
예약된 리소스를 프로비저닝하기 위해 미래용 예약을 위해 자동 생성된 것을 포함해서 기타 예약을 확인하려면 대신 예약 보기를 참조하세요.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 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.futureReservations.list권한이 필요합니다. -
미래용 예약의 세부정보를 보려면 프로젝트에 대한
compute.futureReservations.get권한이 필요합니다. -
이 섹션에서는 지정된 프로젝트에서 초안으로 작성되었거나 제출된 모든 미래용 예약 요청 목록을 보는 방법을 설명합니다. 또한 필터를 사용하여 하나 이상의 속성을 기반으로 결과 범위를 좁힐 수 있습니다.
-
이 섹션에서는 미래용 예약이 공유된 프로젝트 또는 예약 기간의 시작 시간과 같은 미래용 예약 요청의 세부정보를 보는 방법을 설명합니다.
Google Cloud 콘솔에서 예약 페이지로 이동합니다.
미래용 예약 탭을 클릭합니다.
표에서 각 행은 미래용 예약 요청을 설명하고 각 열은 속성을 설명합니다. 예를 들어 총 개수 열은 각 미래용 예약 요청의 예약된 용량을 설명합니다.
선택사항: 테이블에 표시된 미래용 예약 요청을 필터링하려면 다음 중 하나 또는 모두를 수행합니다.
필터 필드에 필터 표현식을 입력합니다.
예를 들어
us-central1-a영역에 생성되었거나 리소스가 10개 넘게 예약된 미래용 예약 요청만 보려면 다음 표현식을 지정합니다.Zone:us-central1-a OR Total Count>10열 표시 옵션을 클릭한 후 테이블을 필터링하려는 값을 선택합니다.
FILTER_EXPRESSION을 필터 표현식으로 바꿉니다.예를 들어
us-central1-a영역에 생성되었고n2-standard-4머신 유형으로 지정되었고, 총 개수가 10개 넘는 미래용 예약만 보려면 다음 필터 표현식을 지정합니다.specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-aPROJECT_ID: 선택사항. 하나 이상의 미래용 예약 요청이 있는 프로젝트의 ID입니다.--project플래그를 생략하면 현재 프로젝트의 ID가 사용됩니다.PROJECT_ID: 하나 이상의 미래용 예약 요청이 있는 프로젝트의 ID입니다.ZONE: 하나 이상의 미래용 예약 요청이 있는 영역입니다.PROJECT_ID: 하나 이상의 미래용 예약 요청이 있는 프로젝트의 ID입니다.FILTER_EXPRESSION: URL 인코딩을 사용하는 필터 표현식입니다.예를 들어
us-central1-a영역에 생성되었고n2-standard-4머신 유형이 예약되었고, 총 개수가 10개 넘는 미래용 예약만 보려면 다음 필터 표현식을 지정합니다.specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10%20AND%20zone=us-central1-aURL로 인코딩된 필터 표현식은 다음 디코딩된 필터 표현식을 나타냅니다.
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-aGoogle Cloud 콘솔에서 예약 페이지로 이동합니다.
미래용 예약 탭을 클릭합니다.
이름 열에서 세부정보를 보려는 미래용 예약 요청의 이름을 클릭합니다.
미래용 예약 요청에 대한 세부정보가 포함된 미래용 예약 페이지가 열립니다.
FUTURE_RESERVATION_NAME: 기존 미래용 예약 요청의 이름입니다.PROJECT_ID: 선택사항. 미래용 예약 요청이 있는 프로젝트의 ID입니다.--project플래그를 생략하면 현재 프로젝트의 ID가 사용됩니다.ZONE: 미래용 예약 요청이 있는 영역입니다.PROJECT_ID: 미래용 예약 요청이 있는 프로젝트의 ID입니다.ZONE: 미래용 예약 요청이 있는 영역입니다.FUTURE_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.futureReservationViewer) IAM 역할을 부여해달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.이 사전 정의된 역할에는 미래용 예약 요청을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.
필수 권한
미래용 예약 요청을 보려면 다음 권한이 필요합니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
미래용 예약 요청 보기
지정된 프로젝트에서 미래용 예약 요청을 보려면 다음 방법 중 하나를 선택합니다.
미래용 예약 요청 목록 보기
Google Cloud 콘솔, gcloud CLI, REST를 사용하여 지정된 프로젝트의 미래용 예약 요청 목록을 볼 수 있습니다.
콘솔
미래용 예약 요청 목록을 보려면 다음 단계를 수행합니다.
gcloud
미래용 예약 요청 목록을 보려면
gcloud beta compute future-reservations list명령어를 사용합니다.gcloud beta compute future-reservations list \ --project=PROJECT_IDPROJECT_ID를 하나 이상의 미래용 예약 요청이 위치한 프로젝트의 ID로 바꿉니다.--project플래그를 생략하면 현재 프로젝트의 ID가 사용됩니다.출력은 다음과 비슷합니다.
NAME TOTAL_COUNT START_TIME END_TIME PROCUREMENT_STATUS ZONE fr-04 100 2025-07-20T07:00:00Z 2025-08-05T07:00:00Z FULFILLED us-east1-a fr-05 10 2025-11-15T00:00:00Z 2025-12-01T00:00:00Z PENDING_APPROVAL us-west1-c선택적으로 필터 표현식을 기반으로 필터링된 미래용 예약 목록을 표시하도록
--filter플래그를 지정할 수 있습니다.gcloud beta compute future-reservations list \ --filter="FILTER_EXPRESSION" \ --project=PROJECT_ID다음을 바꿉니다.
REST
미래용 예약 요청 목록을 보려면
beta.futureResevations.list메서드에 대해GET요청을 수행합니다.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations다음을 바꿉니다.
출력은 다음과 비슷합니다.
{ "id": "projects/my-project/zones/us-east1-a/futureReservations", "items": [ { "id": "743865190848184978", "creationTimestamp": "2025-04-11T18:16:45.274-07:00", "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base", "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978", "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a", "name": "fr-base", "specificSkuProperties": { "instanceProperties": { "machineType": "n1-standard-1" }, "totalCount": "100" }, "planningStatus": "SUBMITTED", "timeWindow": { "startTime": "2025-07-20T07:00:00Z", "endTime": "2025-08-05T07:00:00Z" }, "status": { "procurementStatus": "FULFILLED", "lockTime": "2025-05-04T07:00:00Z", "fulfilledCount": "100" }, "kind": "compute#futureReservation" }, ... ], "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations", "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=", "kind": "compute#futureReservationsListResponse" }필요한 경우 필터 표현식에 따라 필터링된 미래용 예약 목록을 보기 위해
filter쿼리 매개변수를 지정할 수 있습니다.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION다음을 바꿉니다.
미래용 예약 요청 세부정보 보기
Google Cloud 콘솔, gcloud CLI, REST를 사용하여 미래용 예약 요청의 세부정보를 볼 수 있습니다.
콘솔
미래용 예약 요청의 세부정보를 보려면 다음 단계를 수행합니다.
gcloud
미래용 예약 요청의 세부정보를 보려면
gcloud beta compute future-reservations describe명령어를 사용합니다.gcloud beta compute future-reservations describe FUTURE_RESERVATION_NAME \ --project=PROJECT_ID \ --zone=ZONE다음을 바꿉니다.
출력은 다음과 비슷합니다.
creationTimestamp: '2025-07-19T12:44:11.855-07:00' id: '5212276518668495076' kind: compute#futureReservation name: fr-01 namePrefix: test-fr selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1 selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076 shareSettings: projects: - 'project-02' shareType: SPECIFIC_PROJECTS specificSkuProperties: instanceProperties: localSsds: - diskSizeGb: '375' interface: SCSI machineType: n1-standard-64 minCpuPlatform: Intel Skylake totalCount: '800' planningStatus: SUBMITTED status: lockTime: '2025-08-25T00:00:00Z' procurementStatus: APPROVED timeWindow: endTime: '2025-12-10T00:00:00Z' startTime: '2025-11-10T00:00:00Z' zone: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-aREST
미래용 예약 요청의 세부정보를 보려면
beta.futureReservations.get메서드에GET요청을 수행합니다.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/FUTURE_RESERVATION_NAME다음을 바꿉니다.
출력은 다음과 비슷합니다.
{ "creationTimestamp": "2025-04-11T18:16:45.274-07:00", "id": "743865190848184978", "name": "fr-01", "namePrefix": "test-fr", "kind": "compute#futureReservation", "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base", "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978", "specificSkuProperties": { "instanceProperties": { "machineType": "n1-standard-1" }, "totalCount": "100" }, "planningStatus": "SUBMITTED", "timeWindow": { "endTime": "2025-08-05T07:00:00Z", "startTime": "2025-07-20T07:00:00Z" }, "status": { "fulfilledCount": "100" "lockTime": "2025-05-04T07:00:00Z", "procurementStatus": "FULFILLED", }, "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a" }다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-21(UTC)
-