Comprar un compromiso basado en el gasto

En este documento se describe cómo comprar un compromiso basado en el gasto mediante la API Cloud Commerce Consumer Procurement para las compras de Cloud Marketplace.

Actualmente, esta API solo admite la compra de compromisos basados en el gasto, no de compromisos basados en recursos.

Antes de empezar

Identifica la oferta que quieres comprar

Para comprar un compromiso basado en el gasto, utilice un nombre de oferta que indique el producto que va a comprar y el plazo del descuento.

El nuevo modelo de CUD introduce nuevos nombres de oferta para los productos de CUD actuales. En la tabla que aparece a continuación se indican los nombres de las ofertas antes y después de habilitar el nuevo modelo de CUD basado en el gasto. Debes usar el nombre de la oferta que coincida con el modelo de tu cuenta de facturación de Cloud.

Las siguientes ofertas actualizadas están disponibles para su compra:

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

Las siguientes ofertas no se verán afectadas por el nuevo modelo de CUD y se podrán comprar:

Producto Término Nombre de la oferta
Copia de seguridad de GKE 1 año services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7
Copia de seguridad de GKE 3 años services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5
Copia de seguridad y recuperación tras desastres (VMware) 1 año services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a
Copia de seguridad y recuperación tras desastres (VMware) 3 años services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48
NetApp Volumes 1 año services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca
NetApp Volumes 3 años services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c

Identificar los parámetros de la oferta

Los compromisos tienen dos parámetros:

  • Importe del compromiso (hourly_commit): el crédito que se aplica a tu cuenta de Facturación de Cloud cada hora después de comprar este compromiso.

  • Región (region): región en la que se aplican los beneficios de este compromiso.

Cuando compras un compromiso, debes especificar ambos parámetros.

Comprar la oferta

Para comprar una oferta, llama a billingAccounts.orders.place y proporciona los siguientes parámetros:

  • El hourly_commit que indica el valor en dólares del compromiso.

  • El region para comprar el compromiso.

Para hacer un pedido, ejecuta el siguiente comando:

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

Devuelve el nombre de una operación de larga duración:

{
    "name": "OPERATION_NAME"
}

Para verificar que la operación de larga duración devuelta se ha completado correctamente, ejecuta el siguiente comando:

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'

La operación de larga duración debería completarse en menos de un segundo.

Ver tu pedido

Puedes ver el estado actual de un compromiso directamente en la Google Cloud consola o llamando a billingAccounts.orders.get. El campo name del pedido creado especifica el nombre del pedido.

cURL

Para ver un pedido, ejecuta el siguiente comando:

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'

Consola

  1. Ve a https://console.cloud.google.com/billing.
  2. Selecciona tu cuenta de facturación de Cloud.
  3. En la barra lateral, selecciona Compromisos.
  4. El compromiso que has comprado se muestra en la tabla.