Compra un compromiso basado en la inversión

Actualmente, 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 introduce 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 que habilites el 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:

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