查看預約記錄或未來預留項目要求

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

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

  • 查看預訂設定。這項審查可協助您驗證預訂的詳細資料，確保預訂項目符合您的需求，並規劃容量。

  • 決定可消耗的例項數量。這項檢查可協助您判斷有多少個 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.

    2. Set a default region and zone.

      3. Go

      如要在本機開發環境中使用本頁面上的 Go 範例，請先安裝並初始化 gcloud CLI，然後使用您的使用者憑證設定應用程式預設憑證。

      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.

        5. 詳情請參閱 Set up authentication for a local development environment。

      Java

      如要在本機開發環境中使用本頁面上的 Java 範例，請先安裝並初始化 gcloud CLI，然後使用您的使用者憑證設定應用程式預設憑證。

      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.

        5. 詳情請參閱 Set up authentication for a local development environment。

      Node.js

      如要在本機開發環境中使用本頁面上的 Node.js 範例，請先安裝並初始化 gcloud CLI，然後使用您的使用者憑證設定應用程式預設憑證。

      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.

        5. 詳情請參閱 Set up authentication for a local development environment。

      Python

      如要在本機開發環境中使用本頁面上的 Python 範例，請先安裝並初始化 gcloud CLI，然後使用您的使用者憑證設定應用程式預設憑證。

      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.

        5. 詳情請參閱 Set up authentication for a local development environment。

      REST

      如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

        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.

      詳情請參閱 Google Cloud 驗證說明文件中的「驗證以使用 REST」。

必要的角色

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

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

所需權限

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

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

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

查看預訂設定

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

查看預留項目

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

  • 如要查看專案中所有保留項目的總覽，請查看保留項目清單。

  • 如要查看單一預訂的完整詳細資料，請查看預訂詳細資料。

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

主控台

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

    前往「Reservations」(預留項目)

    在「隨需預留項目」分頁 (預設) 中，表格會列出每個預留項目，每個表格欄會說明一項資源。

  2. 選用步驟：在「On-demand reservations」表格中，執行下列任一操作或兩者皆行：

    • 如要顯示預訂的保證數量，請按一下 「資料欄顯示選項...」，選取「保證數量」核取方塊，然後按一下「確定」。

    • 如要縮小保留訂單清單範圍，請在 「Filter」(篩選條件) 欄位中，選取要用來篩選保留訂單的屬性。

  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
}

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

查看未來預留要求

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

  • 如要查看專案中所有未來預留要求的概覽，請查看要求清單。

  • 如要查看單一未來預留要求的完整詳細資料，請查看要求的詳細資料。

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

主控台

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

    前往「Reservations」(預留項目)

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

    表格會列出每個未來預訂要求，每個表格欄會說明一項資源。

  3. 選用步驟：如要縮小要求清單範圍，請在 「Filter」欄位中，選取要用來篩選要求的屬性。

  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

  • 如要查看未來預留要求清單，請向 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"
}

判斷可消耗的例項數量

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

保留項目中的可用例項

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

  • 保證數量 (assuredCount)：在保留區域內實際保留的執行個體數量。這個數字包含為專案保留的執行個體，以及共用預訂的任何專案。

  • 總數 (count)：預訂中指定的預留執行個體數量。這個數字應與保證數量相符。

  • 使用中的機器 (inUseCount)：專案中正在執行的執行個體數量，或共用預留容量的專案。

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

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

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

  1. 查看專案中執行中的執行個體和未使用的保留項目數量，以及要求共用到的任何專案是否符合要求的屬性。

  2. 將符合要求的執行中執行個體和未使用的預留空間數量從總數中減去。

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

主控台

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

    前往「Reservations」(預留項目)

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

    表格會列出每個未來預訂要求，每個表格欄會說明一項資源。

  3. 如要判斷 Compute Engine 在要求開始時間時，打算為該要求保留的執行個體數量，請將「總數量」欄的相符數量欄減去。

    「相符項目數量」欄會顯示下列其中一個警告：

    • 比對計數為零：在您的專案或您要求共用的任何專案中，都沒有相符的執行中執行個體或未使用的預訂。

    • 符合數量等於總數：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. 如要查看未來預留項目要求清單，請對 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"
        }
      }
    }
  ]
}

  2. 針對每項要求，從 totalCount 中減去 count 的值。舉例來說，如果 count 為 50，而 totalCount 為 100，則 Compute Engine 會在要求開始時間自動建立 50 個執行個體的預留項目。

    如果您修改要求，或是建立符合要求的新執行個體或預訂，Compute Engine 會在 30 分鐘內更新 existingMatchingUsageInfo 欄位。如要確認這個欄位上次更新的時間，請檢查 existingMatchingUsageInfo.timestamp 的值。

在日曆模式中，未來預留要求中的可用執行個體

查看未來預留要求的詳細資料時，您可以瞭解 Compute Engine 在要求開始時間時，預計要佈建多少個運算執行個體。無論專案或要求共用專案中是否有相符的執行個體，Compute Engine 都會建立要求中指定的執行個體數量。

後續步驟