Comprar uma oferta de compromisso usando a API Cloud Commerce Consumer Procurement

É possível comprar ofertas usando a API Cloud Procure Commerce do Cloud, uma API para fazer compras no Cloud Marketplace.

Atualmente, a API está em pré-lançamento, e apenas compromissos baseados em gastos podem ser comprados por meio da API. Estas instruções descrevem como comprar um compromisso com base em gastos.

Antes de começar

Identifique a oferta que você quer comprar.

Para adquirir um compromisso com base em gastos, use um nome de oferta que indique o produto que você está comprando e o termo de desconto.

As seguintes ofertas estão disponíveis para compra:

Produto Termo Nome da oferta
Mecanismo do VMWare 1 ano services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e
Mecanismo do VMWare 3 anos services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c

Identifique os parâmetros de oferta

Os compromissos têm dois parâmetros:

  • Valor do compromisso (hourly_commit): o crédito aplicado à sua conta do Cloud Billing a cada hora após a compra do compromisso.
  • Região (region): a região a que os créditos desse compromisso se aplicam.

Ao comprar um compromisso, é necessário especificar os dois parâmetros.

Os produtos têm valores e restrições específicos para os parâmetros. Por exemplo, se você quiser comprar o VMWare Engine, consulte os seguintes valores e restrições:

Produto Compromisso mínimo Compromisso máximo Regiões
Mecanismo do VMWare US$ 5 por hora US$ 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

Comprar a oferta

Para comprar uma oferta, chame billingAccounts.orders.place e forneça os seguintes parâmetros:

  • O hourly_commit que indica o valor em dólares do compromisso.

  • O region para o qual o compromisso será comprado.

Para fazer um pedido, execute o seguinte 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

Isso retorna o nome de uma operação de longa duração:

{
    "name": "OPERATION_NAME"
}

Para verificar se a operação de longa duração retornada foi concluída, execute o seguinte 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'

A operação de longa duração será concluída em menos de um segundo.

Veja seu pedido

É possível ver o estado atual de um compromisso diretamente no Console do Google Cloud ou chamando billingAccounts.orders.get. O campo name do pedido criado especifica o nome dele.

cURL

Para ver um pedido, execute o seguinte 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. Acesse https://console.cloud.google.com/billing.
  2. Selecione sua conta de faturamento do Cloud.
  3. Selecione Compromissos na barra lateral.
  4. O compromisso adquirido é visível na tabela exibida.