このドキュメントでは、予約を表示する方法について説明します。
始める前に
- 予約に関する要件と制限事項を確認します。
-
まだ設定していない場合は、認証を設定します。認証とは、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.admin
)IAM ロールを付与するよう管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。
この事前定義ロールには、予約の表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
予約を表示するには、次の権限が必要です。
-
予約のリストを表示する: プロジェクトに対する
compute.reservations.list
-
予約の詳細を表示する: プロジェクトに対する
compute.reservations.get
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
予約を表示する
現在のプロジェクトで作成された予約のみを表示できます。
共有予約を表示できるのはオーナー プロジェクトのみです。共有予約が共有されているプロジェクトを確認するには、予約の詳細を表示します。
予約のリストを表示する
予約のリストを表示するには、Google Cloud コンソール、gcloud CLI、または REST を使用します。
コンソール
Google Cloud コンソールの [予約] ページに移動します。
[予約] ページが表示されます。
このリストで、行はそれぞれ予約を表し、列はそれぞれプロパティを表します。たとえば、[使用中のマシン] 列には、各予約の使用率と合計容量が表示されます。値 25 (50)
は 50 個の VM の予約を表し、これらのうち 25 個の VM が使用されています。
省略可: 表示される予約とプロパティを変更するには、
[フィルタ] と [列表示オプション] を使用します。gcloud
予約のリストを表示するには、gcloud compute reservations list
コマンドを使用します。
gcloud compute reservations list \
--project=PROJECT_ID
PROJECT_ID
は、予約が存在するプロジェクトの ID に置き換えます。
出力は次の例のようになります。
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" \
--project=PROJECT_ID
次のように置き換えます。
FILTER_EXPRESSION
: フィルタ式。PROJECT_ID
: 予約が存在するプロジェクトの ID。
たとえば、名前が prefix
で始まり、us-central1-a
ゾーンにある予約のみを表示するには、次のコマンドを実行します。
gcloud compute reservations list \
--filter="name~prefix AND zone=us-central1-a" \
--project=example-project
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"
}
必要に応じて、フィルタ式を使用して予約の一覧を絞り込むには、次の GET
リクエストを行います。
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
予約の詳細を表示する
予約の詳細を表示するには、Google Cloud コンソール、gcloud CLI、または REST を使用します。
コンソール
予約の詳細を表示する手順は次のとおりです。
Google Cloud コンソールの [予約] ページに移動します。
[予約] ページが表示されます。
[名前] 列で、記述する予約の名前をクリックします。
予約の詳細ページが表示されます。予約の使用状況を確認するには、予約済みマシンの合計 と 使用されるマシンの合計 のフィールドをご覧ください。
gcloud
予約の詳細を表示するには、gcloud compute reservations describe
コマンドを使用します。
gcloud compute reservations describe RESERVATION_NAME \
--project=PROJECT_ID \
--zone=ZONE
次のように置き換えます。
RESERVATION_NAME
: 既存の予約の名前。PROJECT_ID
: 予約が配置されているプロジェクトの ID。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 が使用されています。
次のステップ
- コミットメントに予約を関連付ける方法を学習する。
- 予約を使用する方法を学習する。
- 予約の変更方法を学習する。
- 予約の削除方法を学習する。