本頁面由 Cloud Translation API 翻譯而成。

查看預約記錄或未來預留項目要求
透過集合功能整理內容你可以依據偏好儲存及分類內容。

本文件說明如何查看預訂或未來預訂要求。如要進一步瞭解不同類型的預留，請參閱「佈建類型」。

查看預訂或未來預訂要求時，您可以執行下列操作：

查看預訂設定。這項審查可協助您驗證預訂的詳細資料，確保預訂項目符合您的需求，並規劃容量。
決定可消耗的例項數量。這項檢查可協助您判斷有多少個 Compute Engine 執行個體可用盡您的預留容量。

限制

您只能在建立共用預留項目或共用未來預留項目的專案中查看這類項目。

事前準備

如果尚未設定，請先設定驗證機制。驗證是指驗證身分，以便存取 Google Cloud 服務和 API 的程序。如要在本機開發環境中執行程式碼或範例，您可以選取下列任一選項，向 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. After installing the Google Cloud CLI, initialize it by running the following command:
  gcloud init
  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
  
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.
Go

To use the Go samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
1. Install the Google Cloud CLI.
2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
3. To initialize the gcloud CLI, run the following command:
  gcloud init
4. If you're using a local shell, then create local authentication credentials for your user account:
  gcloud auth application-default login
  You don't need to do this if you're using Cloud Shell.
  
  If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
For more information, see Set up authentication for a local development environment.
Java

To use the Java samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
1. Install the Google Cloud CLI.
2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
3. To initialize the gcloud CLI, run the following command:
  gcloud init
4. If you're using a local shell, then create local authentication credentials for your user account:
  gcloud auth application-default login
  You don't need to do this if you're using Cloud Shell.
  
  If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
For more information, see Set up authentication for a local development environment.
Node.js

To use the Node.js samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
1. Install the Google Cloud CLI.
2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
3. To initialize the gcloud CLI, run the following command:
  gcloud init
4. If you're using a local shell, then create local authentication credentials for your user account:
  gcloud auth application-default login
  You don't need to do this if you're using Cloud Shell.
  
  If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
For more information, see Set up authentication for a local development environment.
Python

To use the Python samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
1. Install the Google Cloud CLI.
2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
3. To initialize the gcloud CLI, run the following command:
  gcloud init
4. If you're using a local shell, then create local authentication credentials for your user account:
  gcloud auth application-default login
  You don't need to do this if you're using Cloud Shell.
  
  If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
For more information, see Set up authentication for a local development environment.
REST

To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.
For more information, see Authenticate for using REST in the Google Cloud authentication documentation.

必要的角色

如要取得查看預留項目或未來預留項目要求所需的權限，請要求管理員為您授予專案的 Compute Admin (roles/compute.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色包含查看預訂或未來預訂要求所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要查看預留項目或未來預留項目要求，您必須具備下列權限：

如要查看保留項目清單： compute.reservations.list 專案
如要查看未來預留項目要求清單，請在專案中執行 compute.futureReservations.list。
如要查看保留項目的詳細資料： compute.reservations.get 專案上的
如要查看未來預留項目要求的詳細資料，請按照下列步驟操作： compute.futureReservations.get 在專案中

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

查看預訂設定

下列各節將說明如何查看預訂或未來預訂要求的設定。

查看預留項目

如要查看一或多個預訂的設定，請使用本節所述的下列其中一種方法：

如要查看專案中所有保留項目的總覽，請查看保留項目清單。
如要查看單一預訂的完整詳細資料，請查看預訂詳細資料。

如要查看預留記錄中的 deleteAtTime 和 reservationSharingPolicy 欄位 (預覽)，請使用 Google Cloud CLI 查看預留記錄的詳細資料，或使用 REST API 查看預留記錄。如果您不需要這些欄位，請選取下列任一選項來查看預訂：

主控台

在 Google Cloud 控制台，前往「Reservations」(預留項目) 頁面。

前往「預留項目」

在「On-demand reservations」分頁 (預設) 中，表格會列出每個預留項目，每個表格欄會說明一項資源。
選用：在「On-demand reservations」表格中，執行下列任一操作或同時完成兩者：
- 如要顯示預訂的保證數量，請按一下「資料欄顯示選項...」，選取「保證數量」核取方塊，然後按一下「確定」。
- 如要縮小保留訂單清單範圍，請在「Filter」(篩選器) 欄位中，選取要用來篩選保留訂單的屬性。
如要查看預訂詳細資料，請在「名稱」欄中按一下預訂名稱。系統會開啟提供預訂詳細資料的頁面。

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 替換為使用網址編碼值的篩選器運算式。

如要查看預訂的詳細資料，請對 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"
  }
}

查看未來預留要求

如要查看一或多個日後預訂要求的設定，請使用本節所述的下列任一方法：

如要查看專案中所有未來預留要求的概覽，請查看要求清單。
如要查看單一未來預留要求的完整詳細資料，請查看要求的詳細資料。

如要查看未來的預留項目要求，請選取下列任一選項：

主控台

在 Google Cloud 控制台，前往「Reservations」(預留項目) 頁面。

前往「預留項目」
點按「Future reservations」(未來預留項目) 分頁標籤。

表格會列出每個未來預訂要求，每個表格欄會說明一項資源。
選用：如要縮小要求清單範圍，請在「Filter」欄位中，選取要用來篩選要求的屬性。
如要查看要求的詳細資料，請在「名稱」欄中，按一下要求的名稱。系統會開啟一個頁面，其中列出未來預留要求的詳細資料。

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

如要查看未來預留要求清單，請向 beta 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 替換為使用網址編碼值的篩選器運算式。

如要查看未來預留要求的詳細資料，請向 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"
}

判斷可消耗的例項數量

如要判斷可用盡預留容量的運算執行個體數量，請執行下列任一操作：

如要查看可消耗保留項目的執行個體數量上限，請參閱「保留項目中的可消耗執行個體」。
如要查看 Compute Engine 在未來預留要求開始時間時，預計為該要求保留的執行個體數量，請參閱「未來預留要求中的可用執行個體」。

保留項目中的可用例項

查看預訂詳細資料時，您可以查看有多少個運算單元正在使用預訂，以及有多少個運算單元可以使用預訂，方法是檢查下列欄位：

保證數量 (assuredCount)：在保留區域內實際保留的執行個體數量。這個數字包含為專案保留的執行個體，以及共用預訂的任何專案。
總數 (count)：預留作業系統中指定的預留執行個體數量。這個數字應與保證數量相符。

注意： 如果保證數量低於總數，則會保留的例項會少於預期。如要排解這個問題，請參閱「可供使用的 VM 數量減少」一文。
使用中的機器 (inUseCount)：專案中正在執行的執行個體數量，或共用預留空間的專案。

舉例來說，如果保證數量 (assuredCount) 和總數量 (count) 都為 50，且使用保留項目的執行個體數量 (inUseCount) 為 25，則在保留項目完全用盡之前，還能有 25 個執行個體使用保留項目。

未來預留要求中的可用執行個體

您可以決定 Compute Engine 在未來預留要求開始時間建立的運算執行個體數量。如為草稿、待核准或已核准的申請，您可以透過下列方式判斷此數字：

查看專案中執行中的執行個體和未使用的保留項目數量，以及要求共用到的任何專案是否符合要求的屬性。
將符合要求的執行中執行個體和未使用的預留空間數量從總數中減去。

您可以一次為單一或多個要求決定可用例項數量。如果是多項要求，請使用 Google Cloud 控制台或 REST API。如要處理單一要求，請選取下列任一選項：

主控台

在 Google Cloud 控制台，前往「Reservations」(預留項目) 頁面。

前往「預留項目」
點按「Future reservations」(未來預留項目) 分頁標籤。

表格會列出每個未來預訂要求，每個表格欄會描述一項資源。
如要判斷 Compute Engine 在要求開始時間時，打算為該要求保留的執行個體數量，請將「總數量」欄的相符數量欄減去。

「相符項目數量」欄會顯示下列其中一個警告：
- 比對計數為零：在您的專案或您要求共用的任何專案中，都沒有相符的執行中執行個體或未使用的預訂。
- 符合數量等於總數量：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

如要查看未來預留項目要求清單，請對 beta futureReservations.list 方法發出 GET 要求。在要求網址中加入 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

後續步驟

查看預約記錄或未來預留項目要求
透過集合功能整理內容你可以依據偏好儲存及分類內容。