Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 de compromisos basados en los recursos.

Antes de comenzar

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

Identifica la oferta que quieres 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.

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 comprar 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 CUD 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:

El hourly_commit que indica el valor en dólares del compromiso.
La region para la que se comprará el compromiso.

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": "hourly_commit",
        "value": {
            "doubleValue": HOURLY_COMMIT
        }
        }, {
        "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.

Visualiza 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

En la Google Cloud consola de, 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.