Usa la API para comprar un compromiso basado en la inversión

En este documento, se describe cómo comprar un compromiso basado en la inversión con la API de Cloud Commerce Consumer Procurement para las compras de Cloud Marketplace.

Esta API solo admite la compra de compromisos basados en la inversión, no en recursos.

Antes de comenzar

Identifica la oferta que deseas comprar

Para comprar un compromiso basado en la inversión, usa un nombre de oferta que indique el producto que compras y el plazo de descuento. Debes usar el nombre de la oferta que coincida con el modelo de tu cuenta de Facturación de Cloud.

Las siguientes ofertas están disponibles para la compra y siguen el nuevo modelo de consumo (descuento directo, sin créditos) :

Producto Término Alcance Nombre de la oferta Parámetros obligatorios
AlloyDB para PostgreSQL 1 año Global services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2 commitment_amount (recomendado)
o hourly_commit
AlloyDB para PostgreSQL 3 años Global services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a commitment_amount (recomendado)
o hourly_commit
Backup and DR (Oracle) 1 año Global services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82 commitment_amount (recomendado)
o hourly_commit
Backup and DR (Oracle) 3 años Global services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354 commitment_amount (recomendado)
o hourly_commit
BigQuery 1 año Regional services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724 commitment_amount (recomendado)
o hourly_commit,

region
BigQuery 3 años Regional services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a commitment_amount (recomendado)
o hourly_commit,

region
Bigtable 1 año Global services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193 commitment_amount (recomendado)
o hourly_commit
Bigtable 3 años Global services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996 commitment_amount (recomendado)
o hourly_commit
Cloud Run 3 años Regional services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0 commitment_amount (recomendado)
o hourly_commit,

region
Cloud Run año Regional services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5 commitment_amount (recomendado)
o hourly_commit,

region
Cloud SQL 1 año Regional services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3 commitment_amount (recomendado)
o hourly_commit,

region
Cloud SQL 3 años Regional services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8 commitment_amount (recomendado)
o hourly_commit,

region
Compromiso flexible de Compute Engine 1 año Global services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93 commitment_amount (recomendado)
o hourly_commit
Compromiso flexible de Compute Engine 3 años Global services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1 commitment_amount (recomendado)
o hourly_commit
Dataflow 1 año Global services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95 commitment_amount (recomendado)
o hourly_commit
Dataflow 3 años Global services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573 commitment_amount (recomendado)
o hourly_commit
Firestore 1 año Global services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21 commitment_amount (recomendado)
o hourly_commit
Firestore 3 años Global services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300 commitment_amount (recomendado)
o hourly_commit
Plan de ahorro flexible de Gemini Enterprise 1 año Global services/aiplatform.googleapis.com/standardOffers/740fd2e8-ff1d-4304-9e85-61c0f8d75811 commitment_amount
Plan de ahorro flexible de Gemini Enterprise 3 años Global services/aiplatform.googleapis.com/standardOffers/4733352d-24b5-4609-b3ff-d2a694f51654 commitment_amount
Google Kubernetes Engine 1 año Regional services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44 commitment_amount (recomendado)
o hourly_commit,

region
Google Kubernetes Engine 3 años Regional services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015 commitment_amount (recomendado)
o hourly_commit,

region
Managed Service para Apache Kafka 1 año Global services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956 commitment_amount (recomendado)
o hourly_commit
Managed Service para Apache Kafka 3 años Global services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66 commitment_amount (recomendado)
o hourly_commit
Memorystore para Redis 1 año Global services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456 commitment_amount (recomendado)
o hourly_commit
Memorystore 3 años Global services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f commitment_amount (recomendado)
o hourly_commit
Spanner 1 año Global services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403 commitment_amount (recomendado)
o hourly_commit
Spanner 3 años Global services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf commitment_amount (recomendado)
o hourly_commit

Las siguientes ofertas están disponibles para la compra y siguen el modelo de crédito heredado (cargo de precio de lista + compensación de crédito) :

Producto Término Alcance Nombre de la oferta Parámetros obligatorios
Backup and DR (VMWare) 1 año Regional services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a hourly_commit,

region
Backup and DR (VMWare) 3 años Regional services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48 hourly_commit,

region
NetApp Volumes 1 año Global services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca hourly_commit
NetApp Volumes 3 años Global services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c hourly_commit

Identifica los parámetros de la oferta

Estos son los parámetros que debes configurar para comprar la oferta:

  • Commitment_amount (recomendado) o Hourly_commit:

    • Para compromisos en el nuevo modelo de CUD basado en la inversión: commitment_amount (recomendado) o hourly_commit. El parámetro hourly_commit se dejará de usar y se reemplazará por el parámetro genérico commitment_amount en el futuro para los compromisos en el nuevo modelo. Algunos CUD admiten una recurrencia diferente (por hora, mensual, etcétera) y solo admitirán el parámetro commitment_amount. Consulta la columna "Parámetros obligatorios" en las tablas de ofertas para conocer los requisitos específicos.

    • Para ofertas que no se ven afectadas por el nuevo modelo de CUD: Especifica hourly_commit. Esto representa el crédito aplicado a tu cuenta de Facturación de Cloud cada hora. Los CUD heredados no admiten commitment_amount.

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

    • Para compromisos regionales: Especifica la región de destino (por ejemplo, us-central1). Para encontrar carpetas y regiones admitidas para cada producto, consulta la documentación de ese producto o la descripción general de los descuentos por compromiso de uso.
    • Para compromisos globales: Omite este parámetro, ya que los compromisos globales se aplican en todas las regiones.

Compra la oferta

Para comprar una oferta, llama a billingAccounts.orders.place, y proporciona los siguientes parámetros en el cuerpo de la solicitud:

  • El parámetro de valor de compromiso que coincide con tu tipo de CUD:

    • Para compromisos en el nuevo modelo de CUD basado en la inversión: Proporciona commitment_amount (recomendado) o hourly_commit (obsoleto, se quitará en el futuro). Para las nuevas ofertas de CUD (como AI Platform), debes especificar commitment_amount.
    • Para los CUD heredados: Proporciona hourly_commit.

  • La region (solo para compromisos regionales). Si compras un compromiso global, omite el parámetro region.

Para realizar 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": "commitment_amount",
        "value": {
            "doubleValue": COMMITMENT_AMOUNT
        }
        }, {
        "name": "region",
        "value": {
            "stringValue": "REGION"
        }
        }],
        "offer": "OFFER_NAME"
    }]
    }
EOF

Se muestra el nombre de una operación de larga duración:

{
    "name": "OPERATION_NAME"
}

Para verificar que la operación de larga duración que se muestra se completó 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.

Consulta tu pedido

Puedes ver el estado actual de un compromiso directamente en Google Cloud la consola, o bien 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'

Console

  1. En la Google Cloud consola de, ve a tu cuenta de Facturación de Cloud.

    Ir a tu cuenta de Facturación de Cloud

  2. Selecciona Descuentos por compromiso de uso (CUD) en la barra lateral.

  3. Se muestran los compromisos que compraste.