Esta página foi traduzida pela API Cloud Translation.

Compre um compromisso baseado nos gastos

Este documento descreve como comprar um compromisso baseado em gastos através da API Cloud Commerce Consumer Procurement para compras do Cloud Marketplace.

Atualmente, esta API só suporta a compra de compromissos baseados em gastos e não compromissos baseados em recursos.

Antes de começar

Ative a API Cloud Commerce Consumer Procurement para o seu Google Cloud projeto.
Certifique-se de que tem uma das seguintes funções de gestão de identidade e de acesso (IAM) para a conta de faturação do Google Cloud que quer usar para comprar o compromisso:
- Administrador de faturação (roles/billing.admin) para a conta do Cloud Billing de destino OU a Google Cloud organização onde a sua conta de faturação está localizada.
- Administrador da encomenda de aprovisionamento do consumidor (roles/consumerprocurement.orderAdmin) para a conta de faturação do Google Cloud de destino OU a Google Cloud organização onde a sua conta de faturação está localizada.

Identifique a oferta que quer comprar

Para comprar um compromisso baseado em gastos, use um nome da oferta que indique o produto que está a comprar e o prazo do desconto.

O novo modelo de CUD introduz novos nomes de ofertas para produtos de CUD existentes. A tabela abaixo indica os nomes das ofertas antes e depois de ativar o novo modelo de CUD baseado em gastos. Tem de usar 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	Vigência	Nome da oferta
Cópia de segurança do GKE	1 ano	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Cópia de segurança do GKE	3 anos	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
Cópia de segurança e RD (VMWare)	1 ano	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
Cópia de segurança e RD (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`

Identifique os parâmetros da oferta

Os compromissos têm dois parâmetros:

Valor do compromisso (hourly_commit): o crédito aplicado à sua conta de faturação do Google Cloud a cada hora após a compra deste compromisso.
No programa de CUDs antigo, o valor do compromisso é o preço a pedido. Para mais informações sobre as diferenças entre o programa de CUDs baseados em gastos antigo e o novo, consulte Melhorias do programa de CUDs baseados em gastos.
Região (region): a região à qual se aplicam as vantagens deste compromisso.

Quando compra um compromisso, tem de especificar ambos os parâmetros.

Compre 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 comprar o compromisso.

Para fazer uma encomenda, 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

Isto devolve o nome de uma operação de longa duração:

{
    "name": "OPERATION_NAME"
}

Para verificar se a operação de longa duração devolvida foi concluída com êxito, 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.

Veja a sua encomenda

Pode ver o estado atual de um compromisso diretamente na Google Cloud consola ou chamando billingAccounts.orders.get. O campo name da encomenda criada especifica o nome da encomenda.

cURL

Para ver uma encomenda, 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'

Consola

Navegue até https://console.cloud.google.com/billing.
Selecione a sua conta do Cloud Billing.
Selecione Compromissos na barra lateral.
O compromisso comprado é visível na tabela apresentada.