Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

使用 API 購買按照支出計算的承諾使用合約

本文說明如何使用 Cloud Marketplace 購買適用的 Cloud Commerce Consumer Procurement API，購買以消費量為準的承諾。

這個 API 僅支援購買按照支出計算的承諾使用合約，不支援按照資源計算的承諾使用合約。

事前準備

為 Google Cloud 專案啟用 Cloud Commerce Consumer Procurement API。
請確認您具備下列任一 Identity and Access Management (IAM) 角色，可透過 Cloud Billing 帳戶購買約定用量：
- 目標 Cloud Billing 帳戶的帳單管理員 (roles/billing.admin) 或帳單帳戶所在機構的Google Cloud 帳單管理員。
- 目標 Cloud Billing 帳戶或帳單帳戶所在 Google Cloud 機構的消費者採購訂單管理員 (roles/consumerprocurement.orderAdmin)。

找出要購買的方案

如要購買以支出為準的承諾，請使用「方案名稱」，指出您購買的產品和折扣期限，且必須使用與 Cloud Billing 帳戶模式相符的方案名稱。

產品	字詞	範圍	優惠名稱	必要參數
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`
備份和災難復原 (Oracle)	1 年	全球	services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82	`commitment_amount` (建議) 或 `hourly_commit`
備份和災難復原 (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`

你可以購買下列方案，並採用舊版抵免額模式 (清單價格費用 + 抵免額抵銷)：

產品	字詞	範圍	優惠名稱	必要參數
備份和災難復原 (VMWare)	1 年	區域	services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a	`hourly_commit,` `region`
備份和災難復原 (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 Billing 帳戶的抵免額。舊版 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'

長時間執行的作業應在一秒內完成。

查看訂單

您可以直接在 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'

控制台

在 Google Cloud 控制台，前往您的 Cloud Billing 帳戶。

前往 Cloud Billing 帳戶
從側欄選取「承諾使用折扣 (CUD)」。
系統會顯示您購買的承諾使用合約。