API を使用して費用ベースのコミットメントを購入する

このドキュメントでは、Cloud Marketplace で購入する際に Cloud Commerce Consumer Procurement API を使用して費用ベースのコミットメントを購入する方法について説明します。

この API は、リソースベースのコミットメントではなく、費用ベースのコミットメントの購入のみをサポートしています。

始める前に

• プロジェクト Google Cloud で Cloud Commerce Consumer Procurement API を有効にします。

• コミットメントの購入に使用する Cloud 請求先 アカウントに、次のいずれかの Identity and Access Management（IAM） ロールが付与されていることを確認します。

  • 対象の Cloud 請求先アカウント、または請求先アカウントが存在する組織の課金管理者 （roles/billing.admin）または Google Cloud 。

  • 対象の Cloud 請求先アカウント、または請求先アカウントが存在する組織の Google Cloud Consumer Procurement Order 管理者（roles/consumerprocurement.orderAdmin）。

購入する特典を特定する

費用ベースのコミットメントを購入するには、購入するプロダクトと割引期間を示す特典名を使用します。Cloud 請求先アカウントのモデルに一致する特典名を使用する必要があります。

注: このドキュメントでは、クレジットではなく割引を活用する新しい使用量モデルに自動的に移行する一部の費用ベースの確約利用割引（CUD）について説明します。 移行日は、 Google Cloud コンソールの [請求の概要] ページの通知で示されます。改善点、影響を受ける CUD、必要な操作の詳細については、費用ベースの CUD をご覧ください。

次の特典を購入できます。これらは新しい使用量モデル（直接割引、クレジットなし）に準拠しています。

プロダクト	用語	範囲	特典名	必須パラメータ
AlloyDB for PostgreSQL	1 年	グローバル	services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2	commitment_amount（推奨） または hourly_commit
AlloyDB for PostgreSQL	3 年	グローバル	services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a	commitment_amount（推奨） または hourly_commit
Backup and DR（Oracle）	1 年	グローバル	services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82	commitment_amount（推奨） または hourly_commit
Backup and DR（Oracle）	3 年	グローバル	services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354	commitment_amount（推奨） または hourly_commit
BigQuery	1 年	リージョン	services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724	commitment_amount（推奨） または hourly_commit, region
BigQuery	3 年	リージョン	services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a	commitment_amount（推奨） または hourly_commit, region
Bigtable	1 年	グローバル	services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193	commitment_amount（推奨） または hourly_commit
Bigtable	3 年	グローバル	services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996	commitment_amount（推奨） または hourly_commit
Cloud Run	3 年	リージョン	services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0	commitment_amount（推奨） または hourly_commit, region
Cloud Run	年	リージョン	services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5	commitment_amount（推奨） または hourly_commit, region
Cloud SQL	1 年	リージョン	services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3	commitment_amount（推奨） または hourly_commit, region
Cloud SQL	3 年	リージョン	services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8	commitment_amount（推奨） または hourly_commit, region
Compute Engine フレキシブル コミットメント	1 年	グローバル	services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93	commitment_amount（推奨） または hourly_commit
Compute Engine フレキシブル コミットメント	3 年	グローバル	services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1	commitment_amount（推奨） または hourly_commit
Dataflow	1 年	グローバル	services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95	commitment_amount（推奨） または hourly_commit
Dataflow	3 年	グローバル	services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573	commitment_amount（推奨） または hourly_commit
Firestore	1 年	グローバル	services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21	commitment_amount（推奨） または hourly_commit
Firestore	3 年	グローバル	services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300	commitment_amount（推奨） または hourly_commit
Gemini Enterprise Flexible Savings Plan	1 年	グローバル	services/aiplatform.googleapis.com/standardOffers/740fd2e8-ff1d-4304-9e85-61c0f8d75811	commitment_amount
Gemini Enterprise Flexible Savings Plan	3 年	グローバル	services/aiplatform.googleapis.com/standardOffers/4733352d-24b5-4609-b3ff-d2a694f51654	commitment_amount
Google Kubernetes Engine	1 年	リージョン	services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44	commitment_amount（推奨） または hourly_commit, region
Google Kubernetes Engine	3 年	リージョン	services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015	commitment_amount（推奨） または hourly_commit, region
Managed Service for Apache Kafka	1 年	グローバル	services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956	commitment_amount（推奨） または hourly_commit
Managed Service for Apache Kafka	3 年	グローバル	services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66	commitment_amount（推奨） または hourly_commit
Memorystore for Redis	1 年	グローバル	services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456	commitment_amount（推奨） または hourly_commit
Memorystore	3 年	グローバル	services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f	commitment_amount（推奨） または hourly_commit
Spanner	1 年	グローバル	services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403	commitment_amount（推奨） または hourly_commit
Spanner	3 年	グローバル	services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf	commitment_amount（推奨） または hourly_commit

次の特典を購入できます。これらは従来のクレジット モデル（正規価格の請求 + クレジットの相殺）に準拠しています。

プロダクト	用語	範囲	特典名	必須パラメータ
Backup and DR（VMWare）	1 年	リージョン	services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a	hourly_commit, region
Backup and DR（VMWare）	3 年	リージョン	services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48	hourly_commit, region
NetApp Volumes	1 年	グローバル	services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca	hourly_commit
NetApp Volumes	3 年	グローバル	services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c	hourly_commit

特典のパラメータを特定する

特典を購入するには、次のパラメータを設定する必要があります。

• Commitment_amount（推奨）または Hourly_commit:

  • 新しい費用ベースの CUD モデルのコミットメントの場合: commitment_amount（推奨）または hourly_commit。hourly_commit パラメータは最終的に非推奨となり、新しいモデルのコミットメントでは、汎用的な commitment_amount パラメータに置き換えられます。一部の CUD は異なる繰り返し（時間単位、月単位など）をサポートしており、commitment_amount パラメータのみをサポートします。特定の要件については、特典テーブルの [必須パラメータ] 列をご確認ください。

  • 新しい CUD モデルの影響を受けない特典の場合: hourly_commit を指定します。これは、Cloud 請求先アカウントに 1 時間ごとに適用されるクレジットを表します。従来の CUD は commitment_amount をサポートしていません。

• リージョン （region）: このコミットメントの特典が適用されるリージョン。

  • リージョン コミットメントの場合: ターゲット リージョン（us-central1 など）を指定します。各プロダクトのフォルダとサポートされているリージョンを確認するには、そのプロダクトのドキュメントまたは確約利用割引の概要をご覧ください。
  • グローバル コミットメントの場合: グローバル コミットメントはすべてのリージョンに適用されるため、このパラメータは省略します。

特典を購入する

特典を購入するには、 billingAccounts.orders.place を呼び出し、リクエストの本文に次のパラメータを指定します。

• CUD タイプに一致するコミットメント値パラメータ:

  • 新しい費用ベースの CUD モデルのコミットメントの場合: commitment_amount（推奨）または hourly_commit（非推奨、今後削除予定）を指定します。新しい CUD 特典（AI Platform など）の場合は、commitment_amount を指定する必要があります。
  • 従来の CUD の場合: hourly_commit を指定します。

• region（リージョン コミットメントの場合のみ）。グローバル コミットメントを購入する場合は、region パラメータを省略します。

注文するには、次のコマンドを実行します。

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/billingAccounts/BILLING_ACCOUNT_ID/orders:place' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID' \
    -d '@-' <<EOF
    {
    "displayName": "DISPLAY_NAME",
    "lineItemInfo": [{
        "parameters": [{
        "name": "commitment_amount",
        "value": {
            "doubleValue": COMMITMENT_AMOUNT
        }
        }, {
        "name": "region",
        "value": {
            "stringValue": "REGION"
        }
        }],
        "offer": "OFFER_NAME"
    }]
    }
EOF

これにより、長時間実行オペレーションの名前が返されます。

{
    "name": "OPERATION_NAME"
}

返された長時間実行オペレーションが正常に完了したことを確認するには、次のコマンドを実行します。

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/OPERATION_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

長時間実行オペレーションは 1 秒以内に完了します。

ご注文の確認

コミットメントの現在の状態は、 Google Cloud コンソールで直接確認するか、 または billingAccounts.orders.getを呼び出して確認できます。 作成した注文の name フィールドには、注文名を指定します。

cURL

注文を表示するには、次のコマンドを実行します。

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/ORDER_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

コンソール

1. Google Cloud コンソールで Cloud 請求先アカウントに移動します。

   Cloud 請求先アカウントに移動

2. サイドバーから [確約利用割引（CUD）] を選択します。

3. 購入したコミットメントが表示されます。

関連トピック

• 費用ベースの CUD プログラムの改善
• 費用ベースの CUD のデータモデルの変更
• 新しい CUD モデルへの移行のタイムライン
• 移行後に割引を確認する
• 購入する CUD の適切な量を選択する
• 新しい CUD のデータモデルのサンプルクエリ
• 移行された CUD SKU、オファー、使用量モデル ID
• Billing ユーザー インターフェースの改善