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

Habilita la API de Cloud Commerce Consumer Procurement para tu proyecto de Google Cloud .
Asegúrate de tener uno de los siguientes roles de Identity and Access Management (IAM) para la cuenta de facturación de Cloud que deseas usar para comprar el compromiso:
- Administrador de facturación (roles/billing.admin) para la cuenta de Facturación de Cloud de destino O laGoogle Cloud organización en la que se encuentra tu cuenta de facturación.
- Administrador de pedidos de adquisición para consumidores (roles/consumerprocurement.orderAdmin) para la cuenta de Facturación de Cloud de destino O la organización Google Cloud en la que se encuentra tu cuenta de facturación.

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 del descuento.

El nuevo modelo de CUD presenta nombres de ofertas nuevos para los productos de CUD existentes. En la siguiente tabla, se proporcionan los nombres de las ofertas antes y después de la migración al nuevo modelo de CUD basado en la inversión. 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 la compra:

Las siguientes ofertas no se ven afectadas por el nuevo modelo de CUD y están disponibles para la compra:

Producto	Término	Nombre de la oferta
Copia de seguridad para GKE	1 año	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Copia de seguridad para GKE	3 años	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
Backup and DR (VMware)	1 año	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
Backup and DR (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`

Identifica los parámetros de la oferta

Los compromisos tienen dos parámetros:

Importe del compromiso (hourly_commit): Es el crédito que se aplica a tu cuenta de Facturación de Cloud cada hora después de que compras este compromiso.
En el programa de CUD heredado, antes de la migración automática de la cuenta, el importe de compromiso era el precio según demanda. Para obtener más información, consulta CUDs basados en la inversión.
Región (region): Es la región para la que se aplican los beneficios de este compromiso.

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

Compra la oferta

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

hourly_commit que indica el valor en dólares del compromiso.
Es 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

Esto devuelve 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 devolvió 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.

Ver tu pedido

Puedes ver el estado actual de un compromiso directamente en la consola de Google Cloud o llamando abillingAccounts.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

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

Ir a tu cuenta de Facturación de Cloud
Selecciona Descuentos por compromiso de uso (CUD) en la barra lateral.
Se muestran los compromisos que compraste.