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

• Ative a API Cloud Commerce Consumer Procurement para seu projeto do Google Cloud.

• Verifique se você tem um dos seguintes papéis do Gerenciamento de identidade e acesso (IAM, na sigla em inglês) para a conta do Cloud Billing que você quer usar para comprar o compromisso:

  • Administrador de faturamento (roles/billing.admin) da conta de faturamento do Cloud de destino OU a organização do Google Cloud em que a conta de faturamento está localizada.

  • Administrador do pedido de compra do consumidor (roles/consumerprocurement.orderAdmin) da conta de faturamento do Cloud de destino OU a organização do Google Cloud em que a conta de faturamento está localizada.

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:

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:

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 'http://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 'http://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 'http://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/ORDER_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'