予約を表示する

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

予約を表示すると、プロジェクト内のすべての予約の概要を確認したり、予約の構成の詳細を確認できます。共有予約を表示する場合は、オーナー プロジェクトを使用する必要があります。

始める前に

  • まだ設定していない場合は、認証を設定します。認証とは、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
    2. Set a default region and zone.

      3. REST

      このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

必要なロール

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

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

必要な権限

予約を表示するには、次の権限が必要です。

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

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

予約を表示する

表示する予約の詳細に応じて、次のいずれかの方法を選択します。

  • プロジェクト内のすべての予約の概要を確認するには、予約のリストを表示します。

  • 共有予約が共有されているコンシューマー プロジェクトなど、予約の構成の詳細を表示するには、予約の詳細を表示します。

予約のリストを表示する

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

コンソール

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

[予約] に移動

[オンデマンド予約] タブ（デフォルト）の表では、行は予約を表し、列はそのプロパティを表します。たとえば、[使用中のマシン] 列には、各予約の使用率と合計容量が表示されます。値 25 (50) は 50 個の VM の予約を表し、これらのうち 25 個の VM が使用されています。

省略可: 表示される予約とプロパティを変更するには、 [フィルタ] と [列表示オプション] を使用します。

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 は、フィルタ式に置き換えます。

たとえば、名前が prefix で始まり、us-central1-a ゾーンにある予約のみを表示するには、次のコマンドを実行します。

gcloud compute reservations list \
    --filter="name~prefix AND zone=us-central1-a"

REST

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

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

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

  • PROJECT_ID: 予約が存在するプロジェクトの ID。

  • ZONE: 予約が存在するゾーン。

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

{
  "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",
      "minCpuPlatform": "Any CPU Platform",
    },
    "count": "100",
    "inUseCount": "0"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "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
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation"
}

必要に応じて、フィルタ式を使用して予約の一覧を絞り込むには、次のように filter クエリ パラメータを使用します。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION

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

  • PROJECT_ID: 予約が存在するプロジェクトの ID。

  • ZONE: 予約が存在するゾーン。

  • FILTER_EXPRESSION: フィルタ式。

たとえば、名前が prefix で始まり、us-central1-a ゾーンにある予約のみを表示するには、URL エンコード値を使用して、次の GET リクエストを行います。

GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a

予約の詳細を表示する

予約の詳細を表示するには、次のいずれかのオプションを選択します。

コンソール

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

    [予約] に移動

  2. [オンデマンド予約] タブ（デフォルト）の [名前] 列で、詳細を表示する予約の名前をクリックします。

    予約の詳細ページが開きます。予約の使用状況を確認するには、[予約済みマシンの合計] と [使用されるマシンの合計] を確認します。

gcloud

予約の詳細を表示するには、gcloud compute reservations describe コマンドを使用します。

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

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

  • RESERVATION_NAME: 既存の予約の名前。

  • ZONE: 予約が配置されているゾーン。

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

kind: compute#reservation
name: reservation-04
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04
specificReservation:
  count: '50'
  inUseCount: '25'
  instanceProperties:
    guestAccelerators:
    - acceleratorCount: 1
      acceleratorType: nvidia-tesla-t4
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-2
    minCpuPlatform: Any CPU Platform
specificReservationRequired: false
status: READY
zone: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a

予約の使用状況を確認するには、count フィールドと inUseCount フィールドを確認します。この例では、50 個の VM が予約され、25 個の VM が使用されています。

REST

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

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME

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

  • PROJECT_ID: 予約が配置されているプロジェクトの ID。

  • ZONE: 予約が配置されているゾーン。

  • RESERVATION_NAME: 既存の予約の名前。

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

{
  "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-centra1-a",
  "name": "reservation-04",
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-tesla-t4",
          "acceleratorCount": 1
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  }
}

予約の使用状況を確認するには、count フィールドと inUseCount フィールドを確認します。この例では、50 個の VM が予約され、25 個の VM が使用されています。

次のステップ