Compra una oferta de compromiso mediante la API de adquisición de consumidores de Cloud Commerce

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Puedes comprar ofertas mediante la API de Procurement Consumer Cloud de Cloud, una API para realizar compras en Cloud Marketplace.

Actualmente, la API se encuentra en vista previa y solo se pueden comprar compromisos basados en gastos a través de la API. En este instructivo, se describe cómo comprar un compromiso basado en la inversión.

Antes de comenzar

Identifique la oferta que desea 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 período de descuento.

Las siguientes ofertas están disponibles para la compra:

Producto Término Nombre de la oferta
Motor de VMware 1 year services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e
Motor de VMware 3 years services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c

Identifique los parámetros de la oferta

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

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

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

Producto Compromiso mínimo Compromiso máximo Regiones
Motor de VMware $5 por hora $10,000 por hora asia-northeast1
asia-south1
asia-southeast1
australia-southeast1
europe-west2
europe-west3
europe-west4
northamerica-northeast
northamerica-northeast1
southamerica-east1
us-central1
us-east4
us-west2

Compra la oferta

Para comprar una oferta, llama a billingAccounts.orders.place y proporciona los siguientes parámetros:

  • El hourly_commit indica el valor en dólares del compromiso.

  • El region para 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 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 Google Cloud Console o si llamas 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

  1. Navegue a https://console.cloud.google.com/billing.
  2. Selecciona la cuenta de facturación de Cloud.
  3. Selecciona Compromisos en la barra lateral.
  4. El compromiso comprado se muestra en la tabla que se muestra.