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

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

Atualmente, apenas compromissos baseados em gastos para produtos selecionados podem ser comprados por meio da API. Este documento descreve como adquirir um compromisso com base em gastos.

Antes de começar

Identifique a oferta que você quer comprar

Para adquirir um compromisso baseado em gastos, use um nome de oferta que indique o produto que você está comprando e o prazo do desconto.

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

Produto Termo Nome da oferta
Mecanismo de VMWare 1 ano services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e
Mecanismo de VMWare 3 anos services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c
Compromisso flexível do Compute Engine 1 ano services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2
Compromisso flexível do Compute Engine 3 anos services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f
AlloyDB para PostgreSQL 1 ano services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c
AlloyDB para PostgreSQL 3 anos services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5
Cloud Bigtable 1 ano services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39
Cloud Bigtable 3 anos services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff
Cloud Run 1 ano services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e
Cloud Run 3 anos services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c
Cloud Spanner 1 ano services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b
Cloud Spanner 3 anos services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603
Cloud SQL 1 ano services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9
Cloud SQL 3 anos services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33
Kubernetes Engine 1 ano services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1
Kubernetes Engine 3 anos services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578
Memorystore 1 ano services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37
Memorystore 3 anos services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354

Identificar os parâmetros da 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 deste compromisso se aplicam.

Ao adquirir um compromisso, você precisa 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 de 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 comprar o compromisso.

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 com êxito, execute o comando a seguir:

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 precisa ser concluída em menos de um segundo.

Ver seu pedido

É possível visualizar 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 conferir 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 estará visível na tabela exibida.