Fazer upgrade do prazo de compromisso

É possível fazer upgrade do prazo dos seus compromissos de um ano e convertê-los em compromissos de três anos para ter uma taxa de desconto maior para seus recursos confirmados e continuar recebendo os descontos por um período mais longo.

Este documento mostra como fazer upgrade do prazo do seu compromisso de um ano para três.

Limitações

É possível fazer upgrade do prazo apenas para compromissos ativos.
Não é possível fazer upgrade do prazo para compromissos de licença de software.

Como funciona um upgrade de prazo

Quando você faz upgrade do prazo do seu compromisso, a data de validade dele é transferida para o futuro por dois anos. O prazo de compromisso do upgrade torna-se válido à 0h no horário do Pacífico dos EUA e do Canadá (UTC-8 ou, durante o horário de verão, UTC-7) no dia seguinte à operação de upgrade, e você começa a receber o novo percentual de desconto aplicável ao prazo do upgrade.

O upgrade do prazo não afeta as outras propriedades do seu compromisso. As propriedades de compromisso a seguir permanecem as mesmas após a operação de upgrade:

Nome
Data de início
Região
Projeto
Tipo de compromisso
Status de renovação automática
Recursos comprometidos

As reservas anexadas ao seu compromisso continuarão existindo durante a vida útil do período atualizado, a menos que você as substitua manualmente.

Implicações de preços para upgrade de prazos

A taxa de compromisso é a soma dos preços com desconto de todos os recursos confirmados. Quando você faz upgrade do prazo do compromisso, o Compute Engine aplica a nova porcentagem de CUD de três anos e recalcula o preço com desconto para cada recurso confirmado. Para fazer esse recálculo, o Compute Engine usa o preço sob demanda prevalecente de cada recurso no dia em que o prazo original se tornou ativo. Esse novo preço com desconto para cada recurso permanece o mesmo até o final do prazo de upgrade, mesmo que os preços sob demanda sejam alterados.

A tabela a seguir mostra um exemplo em que o prazo de um compromisso (commitment-1) é atualizado em dois anos:

Propriedade de compromisso	Antes do upgrade do prazo	Após o upgrade do prazo
Nome	commitment-1	commitment-1
Tipo	N2	N2
Região	us-central-1	us-central-1
Projeto	example-project-1	example-project-1
Recursos	vCPUs: 200 Memória: 200 GB	vCPUs: 200 Memória: 200 GB
Termo	1 ano	3 anos
Data de início*	1º de janeiro de 2020	1º de janeiro de 2020
Data de término†	1 de janeiro de 2021	1 de janeiro de 2023
Status de renovação automática	Desativada	Desativada

^*O compromisso começa à 0h no horário do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7) na data de início especificada.
^†O compromisso termina à 0h no horário do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7) na data de término especificada.

Considerações de cota durante um upgrade de prazo

Normalmente, não é preciso solicitar cota adicional ao fazer upgrade do prazo do seu compromisso. No entanto, se você fizer upgrade do prazo de um compromisso no mesmo dia que ele expirar, será necessário verificar se ainda há cota suficiente disponível. Isso ocorre porque, no dia em que um compromisso expira, qualquer cota que o compromisso estava usando é liberada de volta para seu pool de cotas disponíveis e pode ser usada por suas outras necessidades empresariais.

Fazer um upgrade de prazo

Faça upgrade do prazo do seu compromisso usando a CLI gcloud, o Console do Google Cloud ou a API Compute Engine.

Permissões exigidas para a tarefa

Para executar essa tarefa, é necessário ter permissões:

compute.commitments.update no projeto ou na organização.

Console

No console do Google Cloud, selecione o projeto em que você quer fazer upgrade do prazo do compromisso e acesse a página Descontos por uso contínuo.

Acesse "Descontos por uso contínuo"
Para iniciar o upgrade de prazo de compromisso, selecione um compromisso de hardware ativo na guia Compromissos de hardware da página Lista de compromissos e clique em Fazer upgrade.
- Outra possibilidade é clicar no nome do compromisso ativo em que você quer o upgrade. Depois que a página Detalhes do compromisso de hardware abrir, clique em Fazer upgrade.
No painel Fazer upgrade do desconto por compromisso de uso exibido, verifique o Novo horário de término do compromisso modificado e clique em Fazer upgrade.
Para concluir a operação de upgrade do prazo e retornar à página Lista de compromissos, na caixa de diálogo Fazer upgrade do compromisso? exibida, revise os Termos e Condições e clique em Fazer upgrade.

gcloud

Para fazer upgrade do prazo do seu compromisso, use o comando atualizar compromissos de computação do gcloud com a sinalização --plan.

gcloud compute commitments update COMMITMENT_NAME \
    --plan=36-month \
    --region=REGION \
    --project=PROJECT_NAME

Substitua:

COMMITMENT_NAME: o nome do compromisso com o upgrade de prazo que você quer.
REGION: a região do seu compromisso ccom o prazo que você quer atualizar.
PROJECT_NAME: o nome do projeto para o qual você quer fazer upgrade do compromisso.

Por exemplo, considere um compromisso de um ano, commitment-upgrade-example, na região us-central1 e para o projeto project-upgrade-example. O comando da CLI gcloud a seguir faz upgrade do prazo do compromisso e o modifica em um compromisso de três anos.

gcloud compute commitments update commitment-upgrade-example \
    --plan=36-month \
    --region=us-central1 \
    --project=project-upgrade-example

API

Para fazer upgrade do prazo do compromisso, use o método regionCommitments.update.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
{
  "name": COMMITMENT_NAME,
  "plan": "THIRTY_SIX_MONTH",
}