Compra una oferta de compromiso con 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 adquirir un compromiso basado en gastos.

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 la organización de Google Cloud 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 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, debes usar un nombre de oferta que indique el producto que compras y el plazo del descuento.

Las siguientes ofertas están disponibles para su compra:

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

• El region para el 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

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 '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.

Cómo ver tu pedido

Puedes ver el estado actual de un compromiso directamente en la consola de Google Cloud o llamando a billingAccounts.orders.get. El campo name del pedido creado especifica el nombre del pedido.

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'