예약 또는 미래용 예약 요청 보기

콘솔

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

   예약으로 이동

   온디맨드 예약 탭(기본값)에서 테이블에 각 예약이 나열되고, 각 테이블 열에 속성 설명이 표시됩니다.

2. 선택사항: 온디맨드 예약 테이블에서 다음 중 하나 또는 모두를 수행합니다.

   • 예약 보장된 개수를 표시하려면 view_column열 표시 옵션...을 클릭하고 보장된 수 체크박스를 선택한 후 확인을 클릭합니다.

   • 예약 목록을 미세 조정하려면 filter_list 필터 필드에서 예약을 필터링하려는 속성을 선택합니다.

3. 예약의 세부정보를 보려면 이름 열에서 예약 이름을 클릭합니다. 예약 세부정보를 제공하는 페이지가 열립니다.

gcloud

• 예약 목록을 보려면 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을 필터 표현식으로 바꿉니다.

• 예약 세부정보를 보려면 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
  

Go

• 예약 목록을 보려면 다음 코드 샘플을 사용하세요.

  // Copyright 2024 Google LLC
  //
  // Licensed under the Apache License, Version 2.0 (the "License");
  // you may not use this file except in compliance with the License.
  // You may obtain a copy of the License at
  //
  //     https://www.apache.org/licenses/LICENSE-2.0
  //
  // Unless required by applicable law or agreed to in writing, software
  // distributed under the License is distributed on an "AS IS" BASIS,
  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  // See the License for the specific language governing permissions and
  // limitations under the License.
  
  package snippets
  
  import (
  	"context"
  	"fmt"
  	"io"
  
  	compute "cloud.google.com/go/compute/apiv1"
  	computepb "cloud.google.com/go/compute/apiv1/computepb"
  	"google.golang.org/api/iterator"
  )
  
  // Get list of reservations for given project in particular zone
  func listReservations(w io.Writer, projectID, zone string) error {
  	// projectID := "your_project_id"
  	// zone := "us-west3-a"
  
  	ctx := context.Background()
  	reservationsClient, err := compute.NewReservationsRESTClient(ctx)
  	if err != nil {
  		return err
  	}
  	defer reservationsClient.Close()
  
  	req := &computepb.ListReservationsRequest{
  		Project: projectID,
  		Zone:    zone,
  	}
  
  	it := reservationsClient.List(ctx, req)
  	fmt.Fprintf(w, "Instances found in zone %s:\n", zone)
  	for {
  		instance, err := it.Next()
  		if err == iterator.Done {
  			break
  		}
  		if err != nil {
  			return err
  		}
  		fmt.Fprintf(w, "- %s %d\n", instance.GetName(), instance.GetSpecificReservation().GetCount())
  	}
  
  	return nil
  }
  
  

• 예약 세부정보를 보려면 다음 코드 샘플을 사용하세요.

  // Copyright 2024 Google LLC
  //
  // Licensed under the Apache License, Version 2.0 (the "License");
  // you may not use this file except in compliance with the License.
  // You may obtain a copy of the License at
  //
  //     https://www.apache.org/licenses/LICENSE-2.0
  //
  // Unless required by applicable law or agreed to in writing, software
  // distributed under the License is distributed on an "AS IS" BASIS,
  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  // See the License for the specific language governing permissions and
  // limitations under the License.
  
  package snippets
  
  import (
  	"context"
  	"fmt"
  	"io"
  
  	compute "cloud.google.com/go/compute/apiv1"
  	computepb "cloud.google.com/go/compute/apiv1/computepb"
  )
  
  // Get certain reservation for given project and zone
  func getReservation(w io.Writer, projectID, zone, reservationName string) (*computepb.Reservation, error) {
  	// projectID := "your_project_id"
  	// zone := "us-west3-a"
  	// reservationName := "your_reservation_name"
  
  	ctx := context.Background()
  	reservationsClient, err := compute.NewReservationsRESTClient(ctx)
  	if err != nil {
  		return nil, err
  	}
  	defer reservationsClient.Close()
  
  	req := &computepb.GetReservationRequest{
  		Project:     projectID,
  		Reservation: reservationName,
  		Zone:        zone,
  	}
  
  	reservation, err := reservationsClient.Get(ctx, req)
  	if err != nil {
  		return nil, fmt.Errorf("unable to delete reservation: %w", err)
  	}
  
  	fmt.Fprintf(w, "Reservation: %s\n", reservation.GetName())
  
  	return reservation, nil
  }
  
  

자바

• 예약 목록을 보려면 다음 코드 샘플을 사용하세요.

  /*
   * Copyright 2024 Google LLC
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *   http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package compute.reservation;
  
  import com.google.cloud.compute.v1.Reservation;
  import com.google.cloud.compute.v1.ReservationsClient;
  import java.io.IOException;
  import java.util.ArrayList;
  import java.util.List;
  
  public class ListReservations {
  
    public static void main(String[] args) throws IOException {
      // TODO(developer): Replace these variables before running the sample.
      // Project ID or project number of the Cloud project you want to use.
      String project = "YOUR_PROJECT_ID";
      // Zone in which reservations are located.
      String zone = "us-central1-a";
  
      listReservations(project, zone);
    }
  
    // List all reservations in the given project and zone.
    public static List<Reservation> listReservations(String project, String zone) throws IOException {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      List<Reservation> listOfReservations = new ArrayList<>();
  
      try (ReservationsClient reservationsClient = ReservationsClient.create()) {
        for (Reservation reservation : reservationsClient.list(project, zone).iterateAll()) {
          listOfReservations.add(reservation);
          System.out.println("Reservation: " + reservation.getName());
        }
      }
      return listOfReservations;
    }
  }

• 예약 세부정보를 보려면 다음 코드 샘플을 사용하세요.

  /*
   * Copyright 2024 Google LLC
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   * http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package compute.reservation;
  
  import com.google.cloud.compute.v1.Reservation;
  import com.google.cloud.compute.v1.ReservationsClient;
  import java.io.IOException;
  import java.util.concurrent.ExecutionException;
  import java.util.concurrent.TimeoutException;
  
  public class GetReservation {
  
    public static void main(String[] args)
        throws IOException, ExecutionException, InterruptedException, TimeoutException {
      // TODO(developer): Replace these variables before running the sample.
      // Project ID or project number of the Cloud project you want to use.
      String projectId = "YOUR_PROJECT_ID";
      // Name of the zone in which you want to create the reservation.
      String zone = "us-central1-a";
      // Name of the reservation you want to create.
      String reservationName = "test-reservation-name";
  
      getReservation(projectId, reservationName, zone);
    }
  
    // Retrieve a reservation with the given name in the given zone.
    public static Reservation getReservation(
        String projectId, String reservationName, String zone)
        throws IOException {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      try (ReservationsClient reservationsClient = ReservationsClient.create()) {
  
        // Get the reservation.
        Reservation reservation = reservationsClient.get(projectId, zone, reservationName);
  
        System.out.println("Reservation: " + reservation.getName());
        return reservation;
      }
    }
  }

Node.js

• 예약 목록을 보려면 다음 코드 샘플을 사용하세요.

  /*
   * Copyright 2024 Google LLC
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *     https://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  'use strict';
  
  async function main() {
    // Import the Compute library
    const computeLib = require('@google-cloud/compute');
  
    // Instantiate a reservationsClient
    const reservationsClient = new computeLib.ReservationsClient();
  
    /**
     * TODO(developer): Update these variables before running the sample.
     */
    // The ID of the project where your reservations are located.
    const projectId = await reservationsClient.getProjectId();
    // The zone where your reservations are located.
    const zone = 'us-central1-a';
  
    async function callGetReservations() {
      const reservations = (
        await reservationsClient.list({
          project: projectId,
          zone,
        })
      )[0];
  
      console.log(JSON.stringify(reservations));
    }
  
    await callGetReservations();
  }
  
  main().catch(err => {
    console.error(err);
    process.exitCode = 1;
  });
  

• 예약 세부정보를 보려면 다음 코드 샘플을 사용하세요.

  /*
   * Copyright 2024 Google LLC
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *     https://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  'use strict';
  
  async function main(reservationName) {
    // Import the Compute library
    const computeLib = require('@google-cloud/compute');
  
    // Instantiate a reservationsClient
    const reservationsClient = new computeLib.ReservationsClient();
  
    /**
     * TODO(developer): Update/uncomment these variables before running the sample.
     */
    // The ID of the project where your reservation is located.
    const projectId = await reservationsClient.getProjectId();
    // The zone where your reservation is located.
    const zone = 'us-central1-a';
    // The name of the reservation to return.
    // reservationName = 'reservation-01';
  
    async function callGetReservation() {
      const requestedReservation = (
        await reservationsClient.get({
          project: projectId,
          zone,
          reservation: reservationName,
        })
      )[0];
  
      console.log(JSON.stringify(requestedReservation));
    }
  
    await callGetReservation();
  }
  
  main(...process.argv.slice(2)).catch(err => {
    console.error(err);
    process.exitCode = 1;
  });
  

Python

• 예약 목록을 보려면 다음 코드 샘플을 사용하세요.

  # Copyright 2024 Google LLC
  #
  # Licensed under the Apache License, Version 2.0 (the "License");
  # you may not use this file except in compliance with the License.
  # You may obtain a copy of the License at
  #
  #    https://www.apache.org/licenses/LICENSE-2.0
  #
  # Unless required by applicable law or agreed to in writing, software
  # distributed under the License is distributed on an "AS IS" BASIS,
  # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  # See the License for the specific language governing permissions and
  # limitations under the License.
  
  
  # This file is automatically generated. Please do not modify it directly.
  # Find the relevant recipe file in the samples/recipes or samples/ingredients
  # directory and apply your changes there.
  
  
  from google.cloud import compute_v1
  from google.cloud.compute_v1.services.reservations.pagers import ListPager
  
  
  def list_compute_reservation(project_id: str, zone: str = "us-central1-a") -> ListPager:
      """
      Lists all compute reservations in a specified Google Cloud project and zone.
      Args:
          project_id (str): The ID of the Google Cloud project.
          zone (str): The zone of the reservations.
      Returns:
          ListPager: A pager object containing the list of reservations.
      """
  
      client = compute_v1.ReservationsClient()
  
      reservations_list = client.list(
          project=project_id,
          zone=zone,
      )
  
      for reservation in reservations_list:
          print("Name: ", reservation.name)
          print(
              "Machine type: ",
              reservation.specific_reservation.instance_properties.machine_type,
          )
      # Example response:
      # Name:  my-reservation_1
      # Machine type:  n1-standard-1
      # Name:  my-reservation_2
      # Machine type:  n1-standard-1
  
      return reservations_list
  
  
  

• 예약 세부정보를 보려면 다음 코드 샘플을 사용하세요.

  # Copyright 2024 Google LLC
  #
  # Licensed under the Apache License, Version 2.0 (the "License");
  # you may not use this file except in compliance with the License.
  # You may obtain a copy of the License at
  #
  #    https://www.apache.org/licenses/LICENSE-2.0
  #
  # Unless required by applicable law or agreed to in writing, software
  # distributed under the License is distributed on an "AS IS" BASIS,
  # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  # See the License for the specific language governing permissions and
  # limitations under the License.
  
  
  # This file is automatically generated. Please do not modify it directly.
  # Find the relevant recipe file in the samples/recipes or samples/ingredients
  # directory and apply your changes there.
  
  
  from google.cloud import compute_v1
  from google.cloud.compute_v1.types import compute
  
  
  def get_compute_reservation(
      project_id: str,
      zone: str = "us-central1-a",
      reservation_name="your-reservation-name",
  ) -> compute.Reservation:
      """
      Retrieves a compute reservation from GCP.
      Args:
          project_id (str): The ID of the Google Cloud project.
          zone (str): The zone of the reservation.
          reservation_name (str): The name of the reservation to retrieve.
      Returns:
          compute.Reservation: The reservation object retrieved from Google Cloud.
      """
  
      client = compute_v1.ReservationsClient()
  
      reservation = client.get(
          project=project_id,
          zone=zone,
          reservation=reservation_name,
      )
  
      print("Name: ", reservation.name)
      print("STATUS: ", reservation.status)
      print(reservation.specific_reservation)
      # Example response:
      # Name:  your-reservation-name
      # STATUS:  READY
      # count: 3
      # instance_properties {
      #   machine_type: "n1-standard-1"
      #   local_ssds {
      #     disk_size_gb: 375
      #     interface: "NVME"
      #   }
      # ...
  
      return reservation
  
  
  

REST

• 예약 목록을 보려면 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
  

  FILTER_EXPRESSION을 URL 인코딩 값을 사용하는 필터 표현식으로 바꿉니다.

• 예약 세부정보를 보려면 GET 요청을 reservations.get 메서드로 전송합니다.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
  

  다음을 바꿉니다.

  • PROJECT_ID: 예약을 만든 프로젝트의 ID입니다.

  • ZONE: 예약이 있는 영역입니다.

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

콘솔

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

   예약으로 이동

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

   표에 각 미래용 예약 요청이 나열되고 각 테이블 열에 속성 설명이 표시됩니다.

3. 선택사항: 요청 목록을 미세 조정하려면 filter_list 필터 필드에서 요청을 필터링하려는 속성을 선택합니다.

4. 요청의 세부정보를 보려면 이름 열에서 요청의 이름을 클릭합니다. 미래용 예약 요청에 대한 세부정보가 포함된 페이지가 열립니다.

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을 필터 표현식으로 바꿉니다.

• 미래용 예약 요청의 세부정보를 보려면 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

• 미래용 예약 요청 목록을 보려면 베타 futureReservations.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
  

  FILTER_EXPRESSION을 URL 인코딩 값을 사용하는 필터 표현식으로 바꿉니다.

• 미래용 예약 요청의 세부정보를 보려면 베타 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"
  }
  

콘솔

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

   예약으로 이동

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

   표에 각 미래용 예약 요청이 나열되고 각 테이블 열에 속성 설명이 표시됩니다.

3. Compute Engine이 시작 시 요청에 대해 예약하려는 인스턴스 수를 결정하려면 총 개수 열에서 일치 개수 열을 뺍니다.

   일치 개수 열에 다음 경고 중 하나가 표시됩니다.

   • 일치 개수가 0임: 사용자의 프로젝트 또는 요청이 공유된 프로젝트에서 일치하는 실행 중인 인스턴스 또는 사용되지 않은 예약이 없습니다.

   • 일치 개수가 총 개수와 같음: Compute Engine이 시작 시 요청에 대해 인스턴스를 예약하지 않습니다.

   요청을 수정하거나 요청과 일치하는 새 인스턴스 또는 예약을 만들면 Compute Engine이 30분 내에 일치 개수 열을 업데이트합니다.

4. 선택사항: 요청에서 일치 개수 열이 마지막으로 업데이트된 시간을 확인하려면 다음을 수행합니다.

   1. 이름 열에서 요청의 이름을 클릭합니다. 미래용 예약 요청에 대한 세부정보가 포함된 페이지가 열립니다.

   2. 리소스 세부정보 섹션에서 마지막 일치 사용량 평가 시간 필드를 확인합니다.

gcloud

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

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

   다음을 바꿉니다.

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

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

   출력에서 count 및 totalCount 필드를 찾습니다.

   ...
   specificSkuProperties:
     ...
     totalCount: '100'
   status:
     existingMatchingUsageInfo:
       count: '50'
       timestamp: '2025-03-30T01:00:00Z'
     ...
     procurementStatus: DRAFTING
   ...
   

2. totalCount에서 count의 값을 뺍니다. 예를 들어 count가 50이고 totalCount가 100이면 Compute Engine이 요청 시작 시에 50개 인스턴스에 대해 자동으로 예약을 만듭니다.

   요청을 수정하거나 요청과 일치하는 새 인스턴스 또는 예약을 만들면 Compute Engine이 30분 내에 existingMatchingUsageInfo 필드를 업데이트합니다. 이 필드가 마지막으로 업데이트된 시점을 확인하려면 existingMatchingUsageInfo.timestamp의 값을 확인합니다.

REST

1. 미래용 예약 요청 목록을 보려면 베타 futureReservations.list 메서드에 대해 GET 요청을 수행합니다. 요청 URL에서 filter 쿼리 파라미터를 포함하고 name, specificSkuProperties, status 필드만 표시하도록 지정합니다.

   GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations?fields=items.name,items.specificSkuProperties,items.status
   

   다음을 바꿉니다.

   • PROJECT_ID: 미래용 예약 요청을 만든 프로젝트의 ID입니다.

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

   출력에서 각 초안, 대기 중인 승인, 승인된 요청에 대해 count 및 totalCount 필드를 찾습니다.

   {
     "items": [
       {
         "specificSkuProperties": {
           ...
           totalCount: "100"
         },
         "name": "fr-01",
         "status": {
           "procurementStatus": "APPROVED",
           ...
           existingMatchingUsageInfo: {
             count: "50",
             "timestamp": "2025-01-22T07:54:26.295Z"
           }
         }
       },
       {
         "specificSkuProperties": {
           ...
           totalCount: "20"
         },
         "name": "fr-02",
         "status": {
           "procurementStatus": "DRAFTING",
           ...
           existingMatchingUsageInfo: {
             "count": "2",
             "timestamp": "2025-01-22T07:54:26.295Z"
           }
         }
       }
     ]
   }
   

2. 각 요청에 대해 totalCount에서 count의 값을 뺍니다. 예를 들어 count가 50이고 totalCount가 100이면 Compute Engine이 요청 시작 시에 50개 인스턴스에 대해 자동으로 예약을 만듭니다.

   요청을 수정하거나 요청과 일치하는 새 인스턴스 또는 예약을 만들면 Compute Engine이 30분 내에 existingMatchingUsageInfo 필드를 업데이트합니다. 이 필드가 마지막으로 업데이트된 시점을 확인하려면 existingMatchingUsageInfo.timestamp의 값을 확인합니다.