미래용 예약 요청 보기

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

미래용 예약 요청을 보면 프로젝트의 모든 미래용 예약 요청을 개략적으로 살펴보고 미래용 예약 요청의 구성 세부정보를 검토할 수 있습니다. 공유 미래용 예약 요청을 보려면 소유자 프로젝트를 사용해야만 볼 수 있습니다.

미래용 예약을 위해 프로비저닝된 자동으로 생성된 예약을 보려면 예약 보기를 참조하세요.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 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 권한이 필요합니다.

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

미래용 예약 요청 보기

미래용 예약 요청에서 보려는 세부정보에 따라 다음 방법 중 하나를 사용합니다.

미래용 예약 요청 목록 보기

미래용 예약 요청 목록을 볼 때 필터 표현식을 사용하여 결과 범위를 좁힐 수 있습니다. 고급 필터 표현식의 경우 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

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

NAME: fr-04
TOTAL_COUNT: 100
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-east1-a

NAME: fr-05
TOTAL_COUNT: 10
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west1-c

원하는 경우 필터 표현식을 기반으로 미래용 예약 요청을 필터링하려면 --filter 플래그를 포함합니다.

gcloud beta compute future-reservations list \
    --filter="FILTER_EXPRESSION"

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

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

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

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-03-23T18: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": {
        "endTime": "2025-05-02T01:00:00Z",
        "startTime": "2025-04-30T17:30:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-03-30T07:00:00Z",
        "existingMatchingUsageInfo": {
          "count": "3",
          "timestamp": "2025-03-30T01:00:00Z"
        }
      },
      "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개 넘는 미래용 예약만 보려면 다음 필터 표현식을 지정합니다.

    zone=us-central1-a%20AND%20specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10

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

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

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

미래용 예약 요청의 세부정보를 보려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

    예약으로 이동

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

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

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

gcloud

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

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

다음을 바꿉니다.

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

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

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

autoCreatedReservationsDeleteTime: '2025-05-02T01:00:00Z'
creationTimestamp: '2025-03-23T10:08:31.613-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
planningStatus: SUBMITTED
selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  shareType: LOCAL
specificSkuProperties:
  instanceProperties:
    machineType: n1-standard-64
  totalCount: '800'
status:
  existingMatchingUsageInfo:
    count: '3'
    timestamp: '2025-03-30T01:00:00Z'
  lockTime: '2025-03-30T17:09:59.297799Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-05-02T01:00:00Z'
  startTime: '2025-04-30T17:30:00Z'
zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a

REST

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

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

다음을 바꿉니다.

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

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

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

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

{
  "autoCreatedReservationsDeleteTime": "2025-05-02T01:00:00Z",
  "creationTimestamp": "2025-03-23T10:08:31.613-07:00",
  "id": "5212276518668495076",
  "kind": "compute#futureReservation",
  "name": "fr-01",
  "planningStatus": "SUBMITTED",
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01",
  "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-64"
    },
    "totalCount": "800"
  },
  "status": {
    "lockTime": "2025-03-30T17:09:59.297799Z",
    "procurementStatus": "APPROVED",
    "existingMatchingUsageInfo": {
      "count": "3",
      "timestamp": "2025-03-30T01:00:00Z"
    }
  },
  "timeWindow": {
    "endTime": "2025-05-02T01:00:00Z",
    "startTime": "2025-04-30T17:30:00Z"
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a"
}

프로비저닝된 VM 수 확인

미래용 예약 요청을 만든 후에는 프로젝트 또는 미래용 예약 요청이 공유된 프로젝트에서 실행 중인 VM 및 사용되지 않은 예약 중 요청에 지정된 VM 속성과 일치하는 수가 얼마인지 확인할 수 있습니다. 이 숫자를 요청에 지정된 총 개수에서 빼면 요청이 승인되고 시작 시간에 도달한 후 Compute Engine에서 프로비저닝할 VM 수를 확인할 수 있습니다.

여러 미래용 예약 요청에 대해 프로비저닝된 VM 수를 동시에 확인하려면 Google Cloud 콘솔을 사용합니다. 그렇지 않은 경우 단일 요청에 대해 프로비저닝된 VM 수를 확인하려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

    예약으로 이동

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

  3. 각 미래용 예약 요청에 대해 다음을 결정할 수 있습니다.

    • 총 개수 열의 요청 총 개수입니다.

    • 일치 개수 열에는 VM 속성이 요청과 일치하는 실행 중인 VM 및 예약의 수가 표시됩니다.

    총 개수 열의 값에서 일치 개수 열의 값을 빼면 Compute Engine에서 미래용 예약 요청의 시작 시간에 미래용 예약 요청에 대해 프로비저닝할 VM 수를 확인할 수 있습니다. 일치 개수 열에 경고가 표시되는 경우 원인은 다음 중 하나입니다.

    • 일치 개수 값은 0입니다. 이 경우 프로젝트에 일치하는 실행 중인 VM 또는 예약이 없습니다.

    • 일치 개수 값은 총 개수와 같습니다. 이 경우 Compute Engine은 미래용 예약 요청에 예약된 VM을 프로비저닝하지 않습니다.

    미래용 예약 요청을 수정하거나 요청과 일치하는 VM 속성을 사용하여 새 VM이나 예약을 만들면 Compute Engine에서 30분 이내에 일치 개수 열의 값을 업데이트합니다. 일치 개수 열이 마지막으로 업데이트된 시점을 확인하려면 요청 세부정보를 보고 최근 사용량 일치 평가 시간 행의 값을 확인합니다.

  4. 선택사항: 미래용 예약 요청에서 예약된 VM 수를 변경하려면 미래용 예약 요청을 수정합니다.

gcloud

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

  2. 출력의 totalCount 필드에서 existingMatchingUsageInfo 필드의 값을 뺍니다. existingMatchingUsageInfo.count 값이 totalCount이면 Compute Engine은 미래용 예약 요청에 예약된 VM을 프로비저닝하지 않습니다.

    미래용 예약 요청을 수정하거나 요청과 일치하는 VM 속성을 사용하여 새 VM이나 예약을 만들면 Compute Engine에서 30분 이내에 existingMatchingUsageInfo 필드를 업데이트합니다. 필드가 마지막으로 업데이트된 시점을 확인하려면 existingMatchingUsageInfo.timestamp 필드 값을 확인합니다.

  3. 선택사항: 미래용 예약 요청에서 예약된 VM 수를 변경하려면 미래용 예약 요청을 수정합니다.

REST

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

  2. 출력의 totalCount 필드에서 existingMatchingUsageInfo 필드의 값을 뺍니다. existingMatchingUsageInfo.count 값이 totalCount이면 Compute Engine은 미래용 예약 요청에 예약된 VM을 프로비저닝하지 않습니다.

    미래용 예약 요청을 수정하거나 요청과 일치하는 VM 속성을 사용하여 새 VM이나 예약을 만들면 Compute Engine에서 30분 이내에 existingMatchingUsageInfo 필드를 업데이트합니다. 필드가 마지막으로 업데이트된 시점을 확인하려면 existingMatchingUsageInfo.timestamp 필드 값을 확인합니다.

  3. 선택사항: 미래용 예약 요청에서 예약된 VM 수를 변경하려면 미래용 예약 요청을 수정합니다.

다음 단계