予約リクエストまたは将来の予約リクエストを表示する

このドキュメントでは、予約または将来の予約リクエストを表示する方法について説明します。さまざまなタイプの予約の詳細については、プロビジョニングタイプをご覧ください。

予約または将来の予約リクエストを表示するときに、次の操作を行うことができます。

予約設定を表示します。この確認は、予約の詳細を確認してニーズを満たしていることを確認し、容量を計画するのに役立ちます。
消費可能なインスタンスの数を決定する。このチェックは、予約済み容量を使用できる Compute Engine インスタンスの数を特定するのに役立ちます。

制限事項

共有予約または共有の将来の予約リクエストを表示できるのは、作成したプロジェクトでのみです。

始める前に

まだ設定していない場合は、認証を設定します。認証とは、 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

必要なロール

予約または将来の予約リクエストを表示するために必要な権限を取得するには、プロジェクトに対する Compute 管理者（roles/compute.admin）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、予約または将来の予約リクエストを表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

予約または将来の予約リクエストを表示するには、次の権限が必要です。

予約のリストを表示する: プロジェクトに対する compute.reservations.list
将来の予約リクエストのリストを表示するには: プロジェクトに対する compute.futureReservations.list
予約の詳細を表示する: プロジェクトに対する compute.reservations.get
将来の予約リクエストの詳細を表示するには: プロジェクトに対する compute.futureReservations.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

予約設定を表示する

以降のセクションでは、予約または将来の予約リクエストの設定を表示する方法について説明します。

予約を表示する

1 つ以上の予約の設定を表示するには、このセクションで説明する次のいずれかの方法を使用します。

プロジェクト内のすべての予約の概要を表示するには、予約のリストを表示します。
単一の予約の詳細を表示するには、予約の詳細を表示します。

予約の deleteAtTime フィールドと reservationSharingPolicy フィールド（プレビュー）を表示するには、Google Cloud CLI を使用して予約の詳細を表示するか、REST API を使用して予約を表示します。これらのフィールドが不要な場合は、次のいずれかのオプションを選択して予約を表示します。

コンソール

Google Cloud コンソールの [予約] ページに移動します。

[予約] に移動

[オンデマンド予約] タブ（デフォルト）の表に、各予約が表示されます。各表の列はプロパティを表します。
省略可: [オンデマンド予約] 表で、次のいずれかまたは両方を行います。
- 予約の保証された数を表示するには、 [列表示オプション...] をクリックし、[保証された数] チェックボックスをオンにして、[OK] をクリックします。
- 予約のリストを絞り込むには、 [フィルタ] フィールドで、予約のフィルタ条件として使用するプロパティを選択します。
予約の詳細を表示するには、[名前] 列で予約の名前をクリックします。予約の詳細が表示されたページが開きます。

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
}

Java

予約のリストを表示するには、次のコードサンプルを使用します。

/*
 * 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

予約のリストを表示するには、reservations.list メソッドに GET リクエストを送信します。

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 エンコードされた値を使用するフィルタ式に置き換えます。

予約の詳細を表示するには、reservations.get メソッドに 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 つ以上の将来の予約リクエストの設定を表示するには、このセクションで説明する次のいずれかの方法を使用します。

プロジェクト内のすべての将来の予約リクエストの概要を確認するには、リクエストのリストを表示します。
1 つの将来の予約リクエストの詳細をすべて表示するには、リクエストの詳細を表示します。

将来の予約リクエストを表示するには、次のいずれかのオプションを選択します。

コンソール

Google Cloud コンソールの [予約] ページに移動します。

[予約] に移動
[将来の予約] タブをクリックします。

この表には、将来の予約リクエストがそれぞれ一覧表示されます。表の各列はプロパティを表します。
省略可: リクエストのリストを絞り込むには、[ フィルタ] フィールドで、リクエストをフィルタするプロパティを選択します。
リクエストの詳細を表示するには、[名前] 列でリクエストの名前をクリックします。将来の予約リクエストの詳細が表示されたページが開きます。

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

消費可能なインスタンスの数を決定する

予約済み容量を使用できるコンピューティングインスタンスの数を確認するには、次のいずれかを行います。

予約を使用できるインスタンスの最大数を確認するには、予約で使用可能なインスタンスをご覧ください。
Compute Engine が将来の予約リクエストの開始時に予約する予定のインスタンス数を確認するには、将来の予約リクエストで使用可能なインスタンスをご覧ください。

予約内の消費可能なインスタンス

予約の詳細を表示すると、次のフィールドを確認することで、予約を使用しているコンピューティングインスタンスの数と、予約を使用できるインスタンスの数を確認できます。

保証された数（assuredCount）: 予約のゾーン内で物理的に予約されるインスタンスの数。この数には、プロジェクト用に予約されたインスタンスと、共有予約が共有されているプロジェクトのインスタンスが含まれます。
合計数（count）: 予約で指定された予約済みインスタンスの数。この数値は保証された数と一致する必要があります。

注意: 保証された数が合計数より少ない場合、想定よりも少ないインスタンスが予約されます。この問題のトラブルシューティングについては、消費可能な VM が少ないをご覧ください。
使用中のマシン（inUseCount）: 予約を使用しているプロジェクト、または共有予約が共有されているプロジェクトで実行中のインスタンスの数。

たとえば、保証された数（assuredCount）と合計数（count）がどちらも 50 で、予約を使用するインスタンスの数（inUseCount）が 25 の場合、予約が完全に使用される前に、さらに 25 個のインスタンスが予約を使用できます。

将来の予約リクエストで使用可能なインスタンス

将来の予約リクエストの開始時に Compute Engine が予約を作成するコンピューティングインスタンスの数を決定できます。ドラフト、承認待ち、承認済みのリクエストの場合、この番号は次の方法で確認できます。

プロジェクト内、およびリクエストが共有されているプロジェクト内の、リクエストプロパティと一致する実行中のインスタンスの数と未使用の予約の数を確認します。
一致する実行中のインスタンスの数と未使用の予約の数を、リクエストの合計数から差し引きます。

1 つまたは複数のリクエストで使用可能なインスタンスの数を一度に決定できます。複数のリクエストの場合は、Google Cloud コンソールまたは REST API を使用します。単一のリクエストの場合は、次のいずれかのオプションを選択します。

コンソール

Google Cloud コンソールの [予約] ページに移動します。

[予約] に移動
[将来の予約] タブをクリックします。

この表には、将来の予約リクエストがそれぞれ一覧表示されます。表の各列はプロパティを表します。
Compute Engine がリクエストの開始時に予約するインスタンスの数を確認するには、[合計数] 列から [一致数] 列を差し引きます。

[一致数] 列には、次のいずれかの警告が表示されます。
- 一致数が 0: プロジェクト内、またはリクエストが共有されているプロジェクト内に、一致する実行中のインスタンスまたは未使用の予約はありません。
- 一致数 = 合計数: Compute Engine は、リクエストの開始時にインスタンスを予約しません。
リクエストを変更するか、リクエストに一致する新しいインスタンスまたは予約を作成すると、Compute Engine によって 30 分以内に [一致数] 列が更新されます。
省略可: リクエストで [一致数] 列が最後に更新された日時を確認するには、次の操作を行います。
1. [名前] 列で、リクエストの名前をクリックします。将来の予約リクエストの詳細が表示されたページが開きます。
2. [リソースの詳細] セクションで、[一致する使用量カウントを最後に評価した日時] フィールドを確認します。

gcloud

将来の予約リクエストの詳細を表示するには、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
...
```
totalCount から count の値を減算します。たとえば、count が 50 で totalCount が 100 の場合、Compute Engine はリクエストの開始時間に 50 個のインスタンスの予約を自動的に作成します。

リクエストを変更するか、リクエストに一致する新しいインスタンスまたは予約を作成すると、Compute Engine は 30 分以内に existingMatchingUsageInfo フィールドを更新します。このフィールドが最後に更新された日時を確認するには、existingMatchingUsageInfo.timestamp の値を確認します。

REST

将来の予約リクエストのリストを表示するには、ベータ版の 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"
        }
      }
    }
  ]
}

リクエストごとに、totalCount から count の値を減算します。たとえば、count が 50 で totalCount が 100 の場合、Compute Engine はリクエストの開始時間に 50 個のインスタンスの予約を自動的に作成します。

リクエストを変更するか、リクエストに一致する新しいインスタンスまたは予約を作成すると、Compute Engine は 30 分以内に existingMatchingUsageInfo フィールドを更新します。このフィールドが最後に更新された日時を確認するには、existingMatchingUsageInfo.timestamp の値を確認します。

次のステップ

コミットメントに予約を関連付ける方法を学習する。
予約を使用する方法を学習する。
予約を変更する方法を学習する。
予約を削除する方法を学習する。

予約リクエストまたは将来の予約リクエストを表示する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

制限事項

始める前に

Console

gcloud

Go

Java

Node.js

Python

REST

必要なロール

必要な権限

予約設定を表示する

予約を表示する

コンソール

gcloud

Go

Java

Node.js

Python

REST

将来の予約リクエストを表示する

コンソール

gcloud

REST

消費可能なインスタンスの数を決定する

予約内の消費可能なインスタンス

将来の予約リクエストで使用可能なインスタンス

コンソール

gcloud

REST

次のステップ

予約リクエストまたは将来の予約リクエストを表示する