Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

リソースベースのコミットメントを表示する

Compute Engine では、購入したすべてのリソースベースのコミットメントのリストを表示したり、特定のコミットメントの詳細なプロパティを取得したりできます。

これらのコミットメントは、 Google Cloud コンソール、gcloud CLI、または REST を使用して表示できます。

始める前に

まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
1. Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
  gcloud init
  外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
  
  注: すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。
デフォルトのリージョンとゾーンを設定します。

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"
}

リソースベースのコミットメントを表示する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

コンソール

gcloud

REST

必要なロール

コミットメントのリストを表示する

コンソール

gcloud

例

REST

特定のコミットメントの詳細を表示する

コンソール

gcloud

例

REST

例

リソースベースのコミットメントを表示する