このドキュメントでは、将来の予約リクエストを表示する方法について説明します。
予約済みリソースをプロビジョニングする将来の予約のために自動作成された予約など、他の予約を表示する方法については、予約を表示をご覧ください。
始める前に
-
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
-
Google Cloud CLI をインストールし、次のコマンドを実行して初期化します。
gcloud init
- デフォルトのリージョンとゾーンを設定します。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
-
必要なロール
将来の予約リクエストを表示するために必要な権限を取得するには、プロジェクトに対する 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-aPROJECT_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-aURL エンコードされたフィルタ式は、次のデコードされたフィルタ式を表すことに留意してください。
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"
}
次のステップ
将来の予約リクエストを変更、キャンセル、削除する方法を学習する。
予約期間の開始時間になったら、自動作成された予約を使用する方法を学習する。
予約期間の終了時間の後に次のことを行う方法を学習する。