本頁面由 Cloud Translation API 翻譯而成。

購買根據支出計算的承諾

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

目前這個 API 僅支援購買以支出為準的承諾使用合約，不支援以資源為準的承諾使用合約。

事前準備

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

找出要購買的方案

如要購買以支出為準的承諾，請使用標明所購產品和折扣條件的方案名稱。

新版 CUD 模式為現有 CUD 產品推出新的方案名稱。下表列出採用新支出計算 CUD 模式前後的方案名稱。您必須使用與 Cloud Billing 帳戶模型相符的方案名稱。

以下更新的方案可供購買：

下列方案不受新 CUD 模式影響，仍可購買：

Product	字詞	方案名稱
GKE 備份	1 年	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
GKE 備份	3 年	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
備份和災難復原 (VMWare)	1 年	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
備份和災難復原 (VMWare)	3 年	`services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48`
NetApp Volumes	1 年	`services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca`
NetApp Volumes	3 年	`services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c`

找出「優惠」參數

承諾有兩個參數：

承諾金額 (hourly_commit)：購買這項承諾後，每小時套用至 Cloud Billing 帳戶的抵免額。
在舊版 CUD 方案中，承諾金額是隨選價格。如要進一步瞭解新舊版依支出計算的 CUD 計畫差異，請參閱「依支出計算的 CUD 計畫改良措施」。
區域 (region)：此承諾的福利適用於該區域。

購買約定時，您必須指定這兩個參數。

購買優惠

如要購買方案，請呼叫 billingAccounts.orders.place，並提供下列參數：

hourly_commit：承諾的金額。
要購買承諾產品的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": "hourly_commit",
        "value": {
            "doubleValue": HOURLY_COMMIT
        }
        }, {
        "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'

控制台

前往 https://console.cloud.google.com/billing。
選取 Cloud Billing 帳戶。
選取側欄中的「承諾」。
您購買的約定會顯示在表格中。