Esta página foi traduzida pela API Cloud Translation.

Adquirir um compromisso com base em gastos

Neste documento, descrevemos como comprar um compromisso baseado em gastos usando a API Cloud Commerce Consumer Procurement para compras no Cloud Marketplace.

No momento, essa API só permite comprar compromissos baseados em gastos, não em recursos.

Antes de começar

Ative a API Cloud Commerce Consumer Procurement para seu projeto Google Cloud .
Verifique se você tem um dos seguintes papéis do Identity and Access Management (IAM) para a conta do Cloud Billing que quer usar para comprar o compromisso:
- Administrador de faturamento (roles/billing.admin) da conta de faturamento de destino do Cloud OU a organizaçãoGoogle Cloud em que sua conta de faturamento está localizada.
- Administrador de pedidos de compras do consumidor (roles/consumerprocurement.orderAdmin) da conta Cloud Billing de destino OU a organização Google Cloud em que sua conta de faturamento está localizada.

Identifique a oferta que você quer comprar

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

O novo modelo de CUD apresenta novos nomes de oferta para produtos de CUD atuais. A tabela abaixo mostra os nomes das ofertas antes e depois de você ativar o novo modelo de CUD com base em gastos. Use o nome da oferta que corresponde ao modelo da sua conta do Cloud Billing.

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

As seguintes ofertas não são afetadas pelo novo modelo de CUD e estão disponíveis para compra:

Produto	Termo	Nome da oferta
Backup para GKE	1 ano	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Backup para GKE	3 anos	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
Backup e DR (VMWare)	1 ano	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
Backup e DR (VMWare)	3 anos	`services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48`
NetApp Volumes	1 ano	`services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca`
NetApp Volumes	3 anos	`services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c`

Identificar os parâmetros da oferta

Os contratos 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.
No programa de CUDs legados, o valor do compromisso é o preço on demand. Para mais informações sobre as diferenças entre o programa legado e o novo de CUDs baseados em gastos, consulte Melhorias no programa de CUDs baseados em gastos.
Região (region): a região em que os benefícios deste compromisso são válidos.

Ao comprar um compromisso, você precisa especificar os dois parâmetros.

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 da fidelidade.
O region para 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 sucesso, 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 deve ser concluída em menos de um segundo.

Ver seu pedido

É possível conferir 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

Acesse https://console.cloud.google.com/billing.
Selecione sua conta de faturamento do Cloud.
Selecione Compromissos na barra lateral.
O compromisso comprado fica visível na tabela mostrada.