미래용 예약 요청 보기


이 문서에서는 미래용 예약 요청을 확인하는 방법을 설명합니다.

예약된 리소스를 프로비저닝하기 위해 미래용 예약을 위해 자동 생성된 것을 포함해서 기타 예약을 확인하려면 대신 예약 보기를 참조하세요.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 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.futureReservationViewer) IAM 역할을 부여해달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

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

필수 권한

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

  • 미래용 예약 목록을 보려면 프로젝트에 대한 compute.futureReservations.list 권한이 필요합니다.
  • 미래용 예약의 세부정보를 보려면 프로젝트에 대한 compute.futureReservations.get 권한이 필요합니다.

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

미래용 예약 요청 보기

지정된 프로젝트에서 미래용 예약 요청을 보려면 다음 방법 중 하나를 선택합니다.

  • 미래용 예약 요청 목록을 봅니다.

    이 섹션에서는 지정된 프로젝트에서 초안으로 작성되었거나 제출된 모든 미래용 예약 요청 목록을 보는 방법을 설명합니다. 또한 필터를 사용하여 하나 이상의 속성을 기반으로 결과 범위를 좁힐 수 있습니다.

  • 미래용 예약 요청 세부정보를 봅니다.

    이 섹션에서는 미래용 예약이 공유된 프로젝트 또는 예약 기간의 시작 시간과 같은 미래용 예약 요청의 세부정보를 보는 방법을 설명합니다.

미래용 예약 요청 목록 보기

Google Cloud 콘솔, gcloud CLI, REST를 사용하여 지정된 프로젝트의 미래용 예약 요청 목록을 볼 수 있습니다.

콘솔

미래용 예약 요청 목록을 보려면 다음 단계를 수행합니다.

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

    예약으로 이동

  2. 미래용 예약 탭을 클릭합니다.

    표에서 각 행은 미래용 예약 요청을 설명하고 각 열은 속성을 설명합니다. 예를 들어 총 개수 열은 각 미래용 예약 요청의 예약된 용량을 설명합니다.

  3. 선택사항: 테이블에 표시된 미래용 예약 요청을 필터링하려면 다음 중 하나 또는 모두를 수행합니다.

    • 필터 필드에 필터 표현식을 입력합니다.

      예를 들어 us-central1-a 영역에 생성되었거나 리소스가 10개 넘게 예약된 미래용 예약 요청만 보려면 다음 표현식을 지정합니다.

      Zone:us-central1-a OR Total Count>10
      
    • 열 표시 옵션을 클릭한 후 테이블을 필터링하려는 값을 선택합니다.

gcloud

미래용 예약 요청 목록을 보려면 gcloud beta compute future-reservations list 명령어를 사용합니다.

gcloud beta compute future-reservations list \
    --project=PROJECT_ID

PROJECT_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

다음을 바꿉니다.

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

    예를 들어 us-central1-a 영역에 생성되었고 n2-standard-4 머신 유형으로 지정되었고, 총 개수가 10개 넘는 미래용 예약만 보려면 다음 필터 표현식을 지정합니다.

    specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
    
  • PROJECT_ID: 선택사항. 하나 이상의 미래용 예약 요청이 있는 프로젝트의 ID입니다. --project 플래그를 생략하면 현재 프로젝트의 ID가 사용됩니다.

REST

미래용 예약 요청 목록을 보려면 beta.futureResevations.list 메서드에 대해 GET 요청을 수행합니다.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

다음을 바꿉니다.

  • PROJECT_ID: 하나 이상의 미래용 예약 요청이 있는 프로젝트의 ID입니다.

  • ZONE: 하나 이상의 미래용 예약 요청이 있는 영역입니다.

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

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

다음을 바꿉니다.

  • 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-a
    

    URL로 인코딩된 필터 표현식은 다음 디코딩된 필터 표현식을 나타냅니다.

    specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
    

미래용 예약 요청 세부정보 보기

Google Cloud 콘솔, gcloud CLI, REST를 사용하여 미래용 예약 요청의 세부정보를 볼 수 있습니다.

콘솔

미래용 예약 요청의 세부정보를 보려면 다음 단계를 수행합니다.

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

    예약으로 이동

  2. 미래용 예약 탭을 클릭합니다.

  3. 이름 열에서 세부정보를 보려는 미래용 예약 요청의 이름을 클릭합니다.

    미래용 예약 요청에 대한 세부정보가 포함된 미래용 예약 페이지가 열립니다.

gcloud

미래용 예약 요청의 세부정보를 보려면 gcloud beta compute future-reservations describe 명령어를 사용합니다.

gcloud beta compute future-reservations describe FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

다음을 바꿉니다.

  • FUTURE_RESERVATION_NAME: 기존 미래용 예약 요청의 이름입니다.

  • PROJECT_ID: 선택사항. 미래용 예약 요청이 있는 프로젝트의 ID입니다. --project 플래그를 생략하면 현재 프로젝트의 ID가 사용됩니다.

  • 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-a

REST

미래용 예약 요청의 세부정보를 보려면 beta.futureReservations.get 메서드GET 요청을 수행합니다.

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

다음을 바꿉니다.

  • PROJECT_ID: 미래용 예약 요청이 있는 프로젝트의 ID입니다.

  • ZONE: 미래용 예약 요청이 있는 영역입니다.

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

다음 단계