使用 Cloud Commerce Consumer Procurement API 购买承诺优惠

您可以使用 Cloud Commerce Consumer Procurement API 购买商品，该 API 用于在 Cloud Marketplace 中进行购买。

目前，只有针对部分产品的基于支出的承诺量可通过 API 购买。本操作说明介绍了如何购买基于支出的承诺。

准备工作

确定您要购买的商品

如需购买基于支出的承诺，您可以使用商品名称来指明您要购买的产品和折扣期限。

以下商品可供购买：

产品 术语 方案名称
AlloyDB for PostgreSQL 1 年 services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c
AlloyDB for PostgreSQL 3 年 services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5
Backup for GKE 1 年 services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7
Backup for GKE 3 年 services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5
备份和灾难恢复 1 年 services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a
备份和灾难恢复 3 年 services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48
Bigtable 1 年 services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39
Bigtable 3 年 services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff
Cloud Run 1 年 services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e
Cloud Run 3 年 services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c
Compute Engine 灵活承诺 1 年 services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2
Compute Engine 灵活承诺 3 年 services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f
Google Kubernetes Engine 1 年 services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1
Google Kubernetes Engine 3 年 services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578
Dataflow 1 年 services/dataflow.googleapis.com/standardOffers/42ae4415-0361-404f-8bc5-1e7c041c2d82
Dataflow 3 年 services/dataflow.googleapis.com/standardOffers/cac998b8-3d49-4672-ae5b-e5b3c56e05f2
Memorystore 1 年 services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37
Memorystore 3 年 services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354
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
Spanner 1 年 services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b
Spanner 3 年 services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603
Cloud SQL 1 年 services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9
Cloud SQL 3 年 services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33

确定优惠参数

承诺有两个参数：

  • 预付金额 (hourly_commit)：您购买此预付款后，系统每小时都会向您的 Cloud Billing 账号应用这笔抵用金。
  • 地区 (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 来查看。创建的 Order 的 name 字段指定了 Order 名称。

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. 前往 https://console.cloud.google.com/billing。
  2. 选择您的 Cloud Billing 账号。
  3. 从边栏中选择承诺。
  4. 您购买的承诺会显示在所显示的表格中。