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

このドキュメントでは、将来の予約リクエストを表示する方法について説明します。

予約済みリソースをプロビジョニングする将来の予約のために自動作成された予約など、他の予約を表示する方法については、予約を表示をご覧ください。

始める前に

まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  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.

必要なロール

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

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

必要な権限

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

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

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

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

指定したプロジェクトで将来の予約リクエストを表示するには、次のいずれかの方法を選択します。

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

このセクションでは、指定したプロジェクトですべての下書きまたは送信済みの将来の予約リクエストの一覧を表示する方法について説明します。フィルタを使用して、1 つ以上の属性に基づいて結果を絞り込むこともできます。
将来の予約リクエストの詳細を表示する。

このセクションでは、将来の予約を共有するプロジェクトや予約期間の開始時間など、将来の予約リクエストの詳細を表示する方法について説明します。

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

Google Cloud コンソール、gcloud CLI、REST を使用して、指定したプロジェクトの将来の予約リクエストのリストを表示できます。

コンソール

将来の予約リクエストのリストを表示するには次の手順を実施します。

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

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

この表の各行は将来の予約リクエストを表し、各列はプロパティを表します。たとえば、[合計数] 列には、将来の予約リクエストそれぞれの予約容量が表示されます。
省略可: テーブルに表示される将来の予約リクエストをフィルタリングするには、次のいずれかまたは両方を行います。
- [フィルタ] フィールドに、フィルタ式を入力します。
  
  たとえば、ゾーン us-central1-a で作成された、または 10 を超えるリソースを予約した将来のリクエストのみを表示するには、次の式を指定します。
```
Zone:us-central1-a OR Total Count>10
```
- [列表示オプション] をクリックし、テーブルをフィルタリングする値を選択します。

gcloud

将来の予約リクエストのリストを表示するには、gcloud beta compute future-reservations list コマンドを使用します。

gcloud beta compute future-reservations list \
    --project=PROJECT_ID

PROJECT_ID は、将来の予約リクエストが 1 つ以上配置されているプロジェクトの ID に置き換えます。--project フラグを省略すると、現在のプロジェクトの ID が使用されます。

出力は次のようになります。

NAME          TOTAL_COUNT    START_TIME             END_TIME               PROCUREMENT_STATUS   ZONE
fr-04         100            2025-07-20T07:00:00Z   2025-08-05T07:00:00Z   FULFILLED            us-east1-a
fr-05         10             2025-11-15T00:00:00Z   2025-12-01T00:00:00Z   PENDING_APPROVAL     us-west1-c

必要に応じて、--filter フラグを指定すると、フィルタ式に基づいてフィルタリングされた将来の予約のリストを表示できます。

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

次のように置き換えます。

FILTER_EXPRESSION は、フィルタ式に置き換えます。

たとえば、ゾーン us-central1-a で作成され、n2-standard-4 マシンタイプが指定され、合計数が 10 より大きい今後の予約のみを表示するには、次のフィルタ式を指定します。
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
```
PROJECT_ID: 省略可。将来の予約リクエストが 1 つ以上存在するプロジェクトの ID。--project フラグを省略すると、現在のプロジェクトの ID が使用されます。

REST

将来の予約リクエストのリストを表示するには、beta.futureResevations.list メソッドに対して GET リクエストを実行します。

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

次のように置き換えます。

PROJECT_ID: 将来の予約リクエストが 1 つ以上存在するプロジェクトの ID。
ZONE: 将来の予約リクエストが 1 つ以上存在するゾーンの ID。

出力は次のようになります。

{
  "id": "projects/my-project/zones/us-east1-a/futureReservations",
  "items": [
    {
      "id": "743865190848184978",
      "creationTimestamp": "2025-04-11T18: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": {
        "startTime": "2025-07-20T07:00:00Z",
        "endTime": "2025-08-05T07:00:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-05-04T07:00:00Z",
        "fulfilledCount": "100"
      },
      "kind": "compute#futureReservation"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

必要に応じて、filter クエリパラメータを指定すると、フィルタ式に基づいてフィルタリングされた将来の予約のリストを表示できます。

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION

次のように置き換えます。

PROJECT_ID: 将来の予約リクエストが 1 つ以上存在するプロジェクトの ID。
FILTER_EXPRESSION: URL エンコードを使用するフィルタ式。

たとえば、ゾーン us-central1-a で作成され、n2-standard-4 マシンタイプを予約し、合計数が 10 より大きい将来の予約のみを表示するには、次のフィルタ式を指定します。
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10%20AND%20zone=us-central1-a
```
URL エンコードされたフィルタ式は、次のデコードされたフィルタ式を表すことに留意してください。
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
```

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

将来の予約リクエストの詳細は、Google Cloud コンソール、gcloud CLI、REST を使用して表示できます。

コンソール

将来の予約リクエストの詳細を表示するには、次の手順を実施します。

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

[予約] に移動
[将来の予約] タブをクリックします。
[名前] 列で、詳細を表示する将来の予約リクエストの名前をクリックします。

[将来の予約] ページが開き、将来の予約リクエストの詳細が表示されます。

gcloud

将来の予約リクエストの詳細を表示するには、gcloud beta compute future-reservations describe コマンドを使用します。

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

次のように置き換えます。

FUTURE_RESERVATION_NAME: 既存の将来の予約リクエストの名前。
PROJECT_ID: 省略可。将来の予約リクエストが存在するプロジェクトの ID。--project フラグを省略すると、現在のプロジェクトの ID が使用されます。
ZONE: 将来の予約リクエストが存在するゾーン。

出力は次のようになります。

creationTimestamp: '2025-07-19T12:44:11.855-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
namePrefix: test-fr
selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  projects:
  - 'project-02'
  shareType: SPECIFIC_PROJECTS
specificSkuProperties:
  instanceProperties:
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-64
    minCpuPlatform: Intel Skylake
  totalCount: '800'
planningStatus: SUBMITTED
status:
  lockTime: '2025-08-25T00:00:00Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-12-10T00:00:00Z'
  startTime: '2025-11-10T00:00:00Z'
zone: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a

REST

将来の予約リクエストの詳細を表示するには、beta.futureReservations.get メソッドに対して GET リクエストを実行します。

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

次のように置き換えます。

PROJECT_ID: 将来の予約リクエストが存在するプロジェクトの ID。
ZONE: 将来の予約リクエストが存在するゾーン。
FUTURE_RESERVATION_NAME: 既存の将来の予約リクエストの名前。

出力は次のようになります。

{
  "creationTimestamp": "2025-04-11T18:16:45.274-07:00",
  "id": "743865190848184978",
  "name": "fr-01",
  "namePrefix": "test-fr",
  "kind": "compute#futureReservation",
  "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",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-1"
    },
    "totalCount": "100"
  },
  "planningStatus": "SUBMITTED",
  "timeWindow": {
    "endTime": "2025-08-05T07:00:00Z",
    "startTime": "2025-07-20T07:00:00Z"
  },
  "status": {
    "fulfilledCount": "100"
    "lockTime": "2025-05-04T07:00:00Z",
    "procurementStatus": "FULFILLED",
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a"
}

次のステップ

将来の予約リクエストを変更、キャンセル、削除する方法を学習する。
予約期間の開始時間になったら、自動作成された予約を使用する方法を学習する。
予約期間の終了時間の後に次のことを行う方法を学習する。
- 自動作成された予約を変更する。
- 自動作成された予約を削除する。

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

始める前に

Console

gcloud

REST

必要なロール

必要な権限

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

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

コンソール

gcloud

REST

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

コンソール

gcloud

REST

次のステップ