购买基于支出的承诺

本文档介绍了如何使用 Cloud Commerce Consumer Procurement API 购买基于支出的承诺，以用于 Cloud Marketplace 购买交易。

目前，此 API 仅支持购买基于支出的承诺，不支持购买基于资源的承诺。

准备工作

确定要购买的优惠

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

新版 CUD 模式为现有 CUD 产品引入了新的优惠名称。下表列出了在您选择启用新版基于支出的 CUD 模式之前和之后的优惠名称。您必须使用与 Cloud Billing 账号的模式相符的优惠名称。

以下更新后的优惠可供购买：

产品 术语 选择启用前的优惠名称 选择启用后的优惠名称
AlloyDB for PostgreSQL 1 年 services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2
AlloyDB for PostgreSQL 3 年 services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5 services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a
Backup and DR (Oracle) 1 年 services/backupdr.googleapis.com/standardOffers/5b446c4d-ce38-4d1a-8c76-e8b04ad50069 services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82
Backup and DR (Oracle) 3 年 services/backupdr.googleapis.com/standardOffers/0dba7aa1-3215-4d44-9581-e1c34ca94471 services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354
BigQuery 1 年 services/bigqueryreservation.googleapis.com/standardOffers/6e72d4d4-5591-4c7f-aa9f-88d277d9280c services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724
BigQuery 3 年 services/bigqueryreservation.googleapis.com/standardOffers/ad5539c4-a0d9-4abd-82c9-1104a7c8ad64 services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a
Bigtable 1 年 services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39 services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193
Bigtable 3 年 services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996
Cloud Run 1 年 services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5
Cloud Run 3 年 services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c？ services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0
Compute Engine 灵活承诺 1 年 services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2 services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93
Compute Engine 灵活承诺 3 年 services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1
Google Kubernetes Engine 1 年 services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1 services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44
Google Kubernetes Engine 3 年 services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578 services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015
Dataflow 1 年 services/dataflow.googleapis.com/standardOffers/42ae4415-0361-404f-8bc5-1e7c041c2d82 services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95
Dataflow 3 年 services/dataflow.googleapis.com/standardOffers/cac998b8-3d49-4672-ae5b-e5b3c56e05f2 services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573
Firestore 1 年 services/firestore.googleapis.com/standardOffers/f8485012-b340-4562-8302-7e27d48f8cfd services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21
Firestore 3 年 services/firestore.googleapis.com/standardOffers/0b48b55a-1fa6-48bc-a3de-2d88f0b99e15 services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300
Managed Service for Apache Kafka 1 年 services/managedkafka.googleapis.com/standardOffers/e1636f7d-1a29-4d53-a89e-c1f60e8dadcf services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956
Managed Service for Apache Kafka 3 年 services/managedkafka.googleapis.com/standardOffers/31d79333-0c0e-4208-9b20-c6e4f27e5d1d services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66
Memorystore for Redis 1 年 services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37 services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456
Memorystore 3 年 services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354 services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f
Spanner 1 年 services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403
Spanner 3 年 services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603 services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf
Cloud SQL 1 年 services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9 services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3
Cloud SQL 3 年 services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33 services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8

以下优惠不受新版 CUD 模式的影响，仍可购买：

产品 术语 优惠名称
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
Backup and DR (VMWare) 1 年 services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a
Backup and DR (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 账号的抵扣金额。

  • 区域 (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'

控制台

  1. 前往 https://console.cloud.google.com/billing。
  2. 选择您的 Cloud Billing 账号。
  3. 从边栏中选择承诺。
  4. 您购买的承诺会显示在显示的表格中。