Esta página se ha traducido con Cloud Translation API.

Usar la API para 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

Habilita la API Consumer Procurement de Cloud Commerce en tu proyecto Google Cloud .
Asegúrate de tener uno de los siguientes roles de Gestión de Identidades y Accesos (IAM) en la cuenta de facturación de Cloud que quieras usar para comprar el compromiso:
- Administrador de facturación (roles/billing.admin) de 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 aprovisionamiento de clientes (roles/consumerprocurement.orderAdmin) de la cuenta de facturación de Cloud de destino O de la organización Google Cloud en la que se encuentra tu cuenta de facturación.

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 incluye nuevos nombres de oferta para los productos de CUD actuales. En la tabla de abajo se muestran 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:

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.
En el programa antiguo de CUDs, el importe de tu compromiso es el precio bajo demanda. Para obtener más información sobre las diferencias entre el programa antiguo y el nuevo de descuentos por compromiso de uso basados en la inversión, consulta Mejoras del programa de descuentos por compromiso de uso basados en la inversión.
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

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

Ir a la cuenta de facturación de Cloud
Seleccione Descuentos por compromiso de uso (CUDs) en la barra lateral.
Se muestran los compromisos que has comprado.