Compra una oferta de compromiso mediante la API de Cloud Commerce Consumer Procurement

Actualmente, solo se pueden comprar compromisos basados en la inversión para productos seleccionados a través de la API. En este instructivo, se describe cómo comprar un compromiso basado en la inversión.

Antes de comenzar

• Habilita la API de Cloud Commerce Consumer Procurement para tu proyecto de Google Cloud.

• Asegúrate de tener una de las siguientes funciones de Identity and Access Management (IAM) para la cuenta de Facturación de Cloud que deseas usar a fin de comprar el compromiso:

  • Administrador de facturación (roles/billing.admin) de la cuenta de Facturación de Cloud de destino O la organización de Google Cloud en la que se encuentra la cuenta de facturación.

  • Administrador de pedidos de adquisición de consumidores (roles/consumerprocurement.orderAdmin) de la cuenta de facturación de Cloud de destino O la organización de Google Cloud en la que se encuentra tu cuenta de facturación.

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 estás comprando y el plazo del descuento.

Puedes comprar las siguientes ofertas:

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 adquirir este compromiso.
• Región (region): Es la región en la que se aplican los créditos de este compromiso.

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

Los productos tienen restricciones y valores específicos para sus parámetros. Por ejemplo, si deseas comprar VMware Engine, puedes consultar los siguientes valores y restricciones:

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 el que se comprará el compromiso.

Para realizar un pedido, ejecuta el siguiente comando:

curl 'http://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 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 haya completado correctamente, ejecuta el siguiente comando:

curl 'http://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 si llamas a billingAccounts.orders.get. El campo name del pedido creado especifica el nombre del pedido.

curl 'http://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/ORDER_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'