使用 Cloud Commerce Consumer Procurement API 购买承诺方案

您可以使用 Cloud Commerce Consumer Procurement API（用于进行 Cloud Marketplace 购买交易的 API）购买优惠。

目前，该 API 处于预览版阶段，只能通过该 API 购买基于支出的承诺。本方法介绍了如何购买基于支出的承诺。

准备工作

为您的 Google Cloud 项目启用 Cloud Commerce Consumer Procurement API。
确保您对要用于购买承诺的 Cloud Billing 帐号具有以下任一 Identity and Access Management (IAM) 角色：
- 目标 Cloud Billing 帐号或者您的结算帐号所在的 Google Cloud 组织的结算管理员 (roles/billing.admin)。
- 目标 Cloud Billing 帐号或您的结算帐号所在 Google Cloud 组织的消费者采购订单管理员(roles/consumerprocurement.orderAdmin)。

识别您想要购买的优惠

如需购买基于支出的承诺，请使用优惠名称，指明您要购买的产品以及折扣期限。

以下优惠可供购买：

产品	期限	优惠名称
VMWare 引擎	1 年	`services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e`
VMWare 引擎	3 年	`services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c`

确定优惠参数

承诺有两个参数：

承诺金额 (hourly_commit)：在您购买此承诺后每小时向您的 Cloud Billing 帐号发放的赠金。
区域 (region)：此承诺的适用区域。

购买承诺时，您必须指定两个参数。

商品的参数有具体值和限制。例如，如果您要购买 VMWare Engine，则可以参阅以下值和限制条件：

产品	最低承诺使用期限	最高承诺	区域
VMWare 引擎	每小时 5 美元	$10000/小时	asia-northeast1 asia-south1 asia-southeast1 australia-southeast1 europe-west2 europe-west3 europe-west4 northamerica-northeast northamerica-northeast1 southamerica-east1 us-central1 us-east4 us-west2

购买优惠

如需购买优惠，请调用 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'

长时间运行的操作应在 1 秒内完成。

查看您的订单

您可以直接在 Google Cloud Console 中或通过调用 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 帐号。
从边栏中选择承诺。
您购买的承诺会显示在显示的表格中。