これらのコミットメントは、 Google Cloud コンソール、gcloud CLI、または REST を使用して表示できます。
始める前に
-
まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
-
Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
gcloud init外部 ID プロバイダ（IdP）を使用してい���場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
-
- デフォルトのリージョンとゾーンを設定します。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Google Cloud CLI をインストールします。
外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
必要なロール
リソースベースのコミットメントを表示するために必要な権限を取得するには、プロジェクトに対する Compute 閲覧者（roles/compute.viewer）または Compute 管理者（roles/compute.admin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
この事前定義ロールには、リソースベースのコミットメントを表示するために必要な compute.commitments.get 権限と compute.commitments.list 権限が含まれています。
カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。
コミットメントのリストを表示する
プロジェクト内のすべてのコミットメントのリストを表示するには、Google Cloud コンソール、gcloud CLI、または REST を使用します。
コンソール
Google Cloud コンソールで [確約利用割引] ページに移動します。 [確約利用割引] ページに移動
特定のカテゴリのコミットメントのリストを表示するには、次のいずれかのタブを選択します。
- ハードウェア コミットメント: このタブを選択すると、vCPU、メモリ、GPU、ローカル SSD ディスク、単一テナントノードなどのハードウェア リソースのコミットメントが表示されます。
- ソフトウェア ライセンス コミットメント: OS ライセンスのコミットメントを表示するには、このタブを選択します。
- ブロック ストレージのコミットメント: このタブを選択すると、Exapool 容量のコミットメントが表示されます。
gcloud
特定のリージョンのすべてのコミットメントを一覧表示するには、gcloud compute commitments list コマンドを使用します。
gcloud compute commitments list \
--regions=REGION \
--project=PROJECT_ID
次のように置き換えます。
REGION: コミットメントを表示するリージョン。PROJECT_ID: プロジェクト ID。
例
たとえば、project-list-example プロジェクトを使用して us-central1 リージョン内のコミットメントを一覧表示するには、次のコマンドを実行します。
gcloud compute commitments list \
--regions=us-central1 \
--project=project-list-example
REST
特定のリージョンのコミットメントを一覧表示するには、regionCommitments.list メソッドに GET リクエストを送信します。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
プロジェクト内のすべてのリージョンのコミットメントを一覧表示するには、regionCommitments.aggregatedList メソッドに GET リクエストを送信します。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments
次のように置き換えます。
PROJECT_ID: コミットメントを表示するプロジェクトのプロジェクト ID。REGION: コミットメントを表示するリージョン。
特定のコミットメントの詳細を表示する
コミットメントの詳細なプロパティ（次のようなもの）を表示できます。
- ステータス
- コミットメント プラン
- コミットメントの開始日時と終了日時
- 自動更新の設定
- 確約されたリソースの種類と量
コミットメントを表示するには、 Google Cloud コンソール、gcloud CLI、または REST を使用します。
コンソール
Google Cloud コンソールで [確約利用割引] ページに移動します。 [確約利用割引] ページに移動
表示するコミットメントのカテゴリのタブを選択します。
- ハードウェア リソースのコミットメントを表示するには、[ハードウェアのコミットメント] タブをクリックします。ハードウェア コミットメントは、vCPU、メモリ、GPU、ローカル SSD ディスク、単一テナントノードを対象としています。
- プレミアム ソフトウェア ライセンスのコミットメントを表示するには、[ソフトウェア ライセンス コミットメント] タブを選択します。ライセンス コミットメントは、SUSE Linux Enterprise Server（SLES）、SLES for SAP、Red Hat Enterprise Linux（RHEL）などのオペレーティング システム（OS）ライセンスを対象としています。
- ネットワーク接続ストレージ プールのコミットメントを表示するには、[ブロック ストレージのコミットメント] タブを選択します。ブロック ストレージのコミットメントは、Exapool の容量をカバーします。
コミットメントの詳細ページを表示するには、コミットメントの名前をクリックします。
gcloud
特定のコミットメントの詳細情報を取得するには、gcloud compute commitments describe コマンドを使用します。
gcloud compute commitments describe COMMITMENT_NAME \
--region=REGION \
--project=PROJECT_ID
次のように置き換えます。
COMMITMENT_NAME: コミットメントの名前。REGION: コミットメントのリージョン���PROJECT_ID: プロジェクト ID。
例
次の例では、myproject プロジェクトと us-central1 リージョンのコミットメントについて説明します。
例 1: ハードウェア コミットメントを記述する
既存のハードウェア コミットメント（example-hardware-commitment）の説明を取得するには、次のコマンドを実行します。
gcloud compute commitments describe example-hardware-commitment \
--region=us-central1 \
--project=myproject
このコマンドは、次のようなコミットメントのプロパティを返します。
autoRenew: true category: MACHINE creationTimestamp: '2025-05-15T09:30:00.000-07:00' endTimestamp: '2026-05-15T09:30:00.000-07:00' kind: compute#commitment name: example-hardware-commitment plan: TWELVE_MONTH region: https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1 resources: - amount: '4' type: VCPU - amount: '16384' type: MEMORY status: ACTIVE type: GENERAL_PURPOSE
例 2: ブロック ストレージ コミットメントの説明を取得する
既存のブロック ストレージ コミットメント（example-block-storage-commitment）の説明を取得するには、gcloud beta compute commitments describe コマンドを実行します。
gcloud beta compute commitments describe example-block-storage-commitment \
--region=us-central1 \
--project=myproject
このコマンドは、コミットメントのプロパティを返し、次のようにコミットメントと Exapool の関係を確立します。
autoRenew: true category: PERSISTENT_DISK creationTimestamp: '2025-08-20T14:45:00.000-07:00' endTimestamp: '2026-08-20T14:45:00.000-07:00' kind: compute#commitment name: example-block-storage-commitment persistentDiskResources: - amount: '102400' dimensionType: CAPACITY_OPTIMIZED productType: HYPERDISK_EXAPOOL_BALANCED plan: TWELVE_MONTH region: https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1 status: ACTIVE
REST
regionCommitments.get メソッドに GET リクエストを送信します。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
次のように置き換えます。
PROJECT_ID: プロジェクトのプロジェクト ID。REGION: コミットメントが購入されたリージョン。COMMITMENT_NAME: コミットメントの名前。
例
次の例では、myproject プロジェクトと us-central1 リージョンのコミットメントの詳細を取得します。
例 1: ハードウェア コミットメントを記述する
ハードウェア コミットメント（example-hardware-commitment）のプロパティを取得するには、次の GET リクエストを送信します。
GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment
レスポンスには、次の出力のようなハードウェア コミットメントのプロパティが含まれます。
{
"autoRenew": true,
"category": "MACHINE",
"creationTimestamp": "2025-05-15T09:30:00.000-07:00",
"endTimestamp": "2026-05-15T09:30:00.000-07:00",
"kind": "compute#commitment",
"name": "example-hardware-commitment",
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1",
"resources": [
{
"amount": "4",
"type": "VCPU"
},
{
"amount": "16384",
"type": "MEMORY"
}
],
"status": "ACTIVE",
"type": "GENERAL_PURPOSE"
}
例 2: ブロック ストレージ コミットメントの説明を取得する
ブロック ストレージ コミットメント（example-block-storage-commitment）のプロパティを取得するには、beta regionCommitments.get メソッドに次の GET リクエストを送信します。
GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment
レスポンスには、次の JSON 出力のように、ブロック ストレージのコミットメント容量を表すプロパティが含まれます。
{
"autoRenew": true,
"category": "PERSISTENT_DISK",
"creationTimestamp": "2025-08-20T14:45:00.000-07:00",
"endTimestamp": "2026-08-20T14:45:00.000-07:00",
"kind": "compute#commitment",
"name": "example-block-storage-commitment",
"persistentDiskResources": [
{
"amount": "102400",
"dimensionType": "CAPACITY_OPTIMIZED",
"productType": "HYPERDISK_EXAPOOL_BALANCED"
}
],
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1",
"status": "ACTIVE"
}