Estenda o prazo dos compromissos

As extensões de vigência oferecem a flexibilidade de estender a vigência de um compromisso além dos períodos predefinidos de um ou três anos e especificar uma vigência personalizada de sua escolha, por exemplo, dois, três anos e meio ou cinco anos e meio. Ao estender o prazo do seu compromisso, você pode personalizar o período para atender às suas necessidades de uso de recursos e continuar recebendo os descontos por compromisso de uso (CUDs) resultantes por esse período mais longo e personalizado. É possível estender os prazos de vigência dos contratos de um e três anos da seguinte maneira:

  • Compromissos de um ano: é possível especificar períodos personalizados maiores que um ano e menores que três anos.
  • Compromissos de três anos: é possível especificar períodos personalizados maiores que três anos e menores que seis anos.

Para outras maneiras de manter seus compromissos ativos por mais tempo, consulte as alternativas a seguir:

Como funciona a extensão de prazo

É possível estender o período do seu compromisso e definir um período personalizado especificando uma data de término futura. Seu compromisso se torna um compromisso de prazo personalizado. Para compromissos de um ano, a data de término personalizada pode ser de um a três anos (mas não pode ser exatamente três anos) após a data de início do período atual. Para compromissos de três anos, a data de término personalizada pode ser de três a seis anos (mas não pode ser exatamente seis anos) após a data de início do período atual.

É possível realizar uma extensão de prazo para compromissos novos e atuais da seguinte maneira:

Depois que você faz um pedido de extensão de prazo para seu compromisso, as mudanças entram em vigor à 0h no horário do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7 durante o horário de verão) do dia seguinte. Seu compromisso vai permanecer ativo até a nova data de término personalizada e o período será ajustado de acordo com isso. A extensão do prazo do compromisso não afeta as outras propriedades:

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

O aumento do período do compromisso não muda a porcentagem de CUD que você recebe em troca.

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

Janela de qualificação para extensão de vigência

Após o início do período de um compromisso, você tem um período limitado para solicitar uma extensão. Esse período é chamado de janela de qualificação para extensão de prazo.

Para períodos predefinidos e personalizados, a janela de qualificação para extensão do período depende da operação mais recente que você realizou em um compromisso e funciona da seguinte maneira:

  • Compromissos recém-comprados: para compromissos de um ano, a janela de qualificação permanece aberta até quatro meses após a ativação do compromisso. Para compromissos de três anos, a janela de qualificação permanece aberta por até um ano após a ativação do compromisso.

  • Compromissos renovados automaticamente: se o compromisso for renovado automaticamente para um novo período, a janela de qualificação vai ser atualizada no início do período renovado. Para compromissos de 1 ano, a janela de qualificação permanece aberta por até 4 meses a partir do início do período renovado. Para compromissos de três anos, a janela de qualificação permanece aberta por até um ano a partir do início do período renovado.

  • Compromissos mesclados: se você mesclar compromissos com janelas de qualificação diferentes, o Compute Engine vai usar a janela de qualificação que terminar primeiro.

  • Compromissos de divisão: quando você divide um compromisso, a janela de qualificação permanece a mesma para o compromisso de origem redimensionado e o novo compromisso de divisão.

  • Compromissos atualizados: quando você faz upgrade de um compromisso de um ano para um de três anos, o Compute Engine também atualiza a janela de qualificação do compromisso. A janela atualizada permanece aberta por até um ano a partir do início do período atual.

    Por exemplo, suponha que a data de início do seu compromisso de um ano seja 1º de janeiro de 2024. O período de qualificação do seu período original de um ano vai permanecer aberto até 1º de maio de 2024. Suponha que você tenha feito upgrade desse compromisso para um de três anos em 1º de abril de 2024. Após o upgrade do período, a janela de qualificação atualizada do seu compromisso vai permanecer aberta até 1º de janeiro de 2025.

Como realizar várias extensões de prazo

Você pode estender o período do seu compromisso quantas vezes quiser dentro da janela de qualificação para extensão do período. Em qualquer dia, para qualquer compromisso ativo, é possível fazer várias solicitações de extensão de prazo até as 0h do Horário do Pacífico (UTC-8 ou UTC-7) do dia seguinte, desde que você especifique uma data de término posterior a cada vez. No entanto, o Google recomenda que você minimize o número de solicitações de extensão de prazo que você faz para um único compromisso em um determinado dia.

Depois que a extensão de vigência para uma data de término específica entrar em vigor e a vigência do compromisso tiver uma nova data de término personalizada, não será possível desfazer a extensão nem reduzir a vigência do compromisso. É possível realizar operações de extensão posteriores apenas para datas de término posteriores à data de término especificada mais recentemente.

Impacto das solicitações de atualização de compromisso pendente

Para compromissos ativos que já têm uma solicitação de atualização pendente, você só pode fazer uma nova solicitação de extensão de prazo se a solicitação pendente também for para uma extensão de prazo. Se os compromissos tiverem algum pedido de atualização pendente, como mesclagem, divisão, upgrade de termo ou atualização da configuração de renovação automática, aguarde a conclusão das operações pendentes e a entrada em vigor das atualizações para solicitar extensões de termo. Depois da meia-noite do dia seguinte, quando as atualizações entrarem em vigor, você poderá solicitar uma prorrogação do prazo para esse compromisso.

Implicações nos preços

A taxa de compromisso é a soma dos preços com desconto de todos os recursos confirmados. Quando você estende o período do compromisso, os preços com desconto dos recursos permanecem os mesmos durante todo o período personalizado, mesmo que os preços sob demanda mudem. Para mais informações sobre os preços dos recursos, consulte Preços do Compute Engine.

Considerações de cota

Para especificar uma data de término personalizada ao adquirir um compromisso, é necessário ter cota suficiente disponível para o compromisso e os recursos confirmados. Para especificar uma data de término personalizada para um compromisso atual, normalmente não é necessário solicitar cota adicional.

Como a extensão de prazo afeta as operações de compromisso futuras

Se o compromisso tiver um período personalizado, a realização de operações de gerenciamento de compromisso subsequentes nele pode afetar a data de término personalizada e a janela de qualificação. As seções a seguir explicam como um compromisso de período personalizado se comporta durante outras operações de compromisso:

Compromissos de período personalizado com renovação automática

A duração renovada de um compromisso renovado automaticamente sempre corresponde ao período predefinido definido pelo plano do compromisso, que é de um ou três anos. Você também recebe a mesma porcentagem de desconto. Mesmo que seu compromisso tenha um período personalizado, o Compute Engine renova seu compromisso apenas pelo período predefinido de um ou três anos. A renovação automática de um compromisso de período personalizado não será para outro período dessa duração. Confira exemplos:

  • Um compromisso com um período personalizado de 1,5 ano será renovado apenas por mais um ano.
  • Um compromisso com um período personalizado de 5,5 anos será renovado apenas por mais três anos.

Se você quiser que um compromisso de período personalizado permaneça ativo por um período maior do que o período renovado, solicite outra extensão de período após a renovação. A janela de qualificação para extensão de período também é atualizada no início do período renovado. Para um compromisso de um ano, a janela de qualificação durante o período renovado permanece aberta por até quatro meses após a renovação. Para compromissos de três anos, essa janela permanece aberta por até um ano após a renovação.

Por exemplo, suponha que a data de início do seu compromisso de um ano tenha sido 1º de janeiro 2024. Você estende o prazo desse compromisso e especifica uma data de término personalizada em 30 de junho de 2025. Se você também ativou a renovação automática no seu compromisso, ele será renovado por mais um ano em 1º de julho de 2025. A data de término do período renovado será 30 de junho de 2026. O período de qualificação para extensão de contrato durante esse período renovado permanece aberto até 1º de novembro de 2025.

Para mais informações sobre a renovação automática de compromissos, consulte Renovar compromissos automaticamente.

Como mesclar compromissos de prazo personalizados

A mesclagem de compromissos com períodos personalizados funciona da mesma forma que os compromissos com períodos predefinidos. O compromisso mesclado herda as seguintes propriedades:

  • A data de término mais distante entre os compromissos de origem, independente de ser uma data de término personalizada ou não.
  • O período de qualificação que termina primeiro entre os compromissos de origem.

Por exemplo, suponha que você queira mesclar dois compromissos de 1 ano de prazo personalizado. A primeira tem data de início em 1º de janeiro de 2024 e data de término em 30 de junho de 2025. O período de qualificação para o primeiro compromisso vai permanecer aberto até 1º de maio de 2024. O segundo compromisso tem uma data de início de 1º de fevereiro de 2024 e uma data de término personalizada de 30 de julho de 2025. O período de qualificação para o segundo compromisso vai até 1º de junho de 2024. Se você mesclar esses compromissos em 1º de abril de 2024, o compromisso mesclado vai herdar 30 de julho de 2025 como data final. A janela de qualificação para o compromisso combinado vai permanecer aberta até 1º de maio de 2024.

Para mais informações sobre como mesclar compromissos, consulte Como mesclar compromissos.

Como dividir compromissos de período personalizado

A divisão de compromissos com duração personalizada funciona da mesma forma que compromissos com duração predefinida. O compromisso de origem redimensionado e os novos compromissos divididos mantêm a mesma data de término personalizada e a mesma janela de qualificação para extensão do termo.

Por exemplo, suponha que a data de início do seu compromisso de um ano seja 1º de janeiro de 2024 e que tenha uma data de término personalizada de 30 de junho de 2025. O período de qualificação para seu compromisso vai permanecer aberto até 1º de maio de 2024. Suponha que, em 1º de março de 2024, você divida esse compromisso em dois compromissos separados. As transações recém-divididas herdam a data de término personalizada de 30 de junho de 2025, e os períodos de qualificação continuam abertos até 1º de maio de 2024.

Para mais informações sobre como dividir compromissos, consulte Como dividir compromissos.

Como fazer upgrade de contratos de prazo personalizado

O upgrade de compromissos de um ano com um período de vigência personalizado funciona da mesma forma que os compromissos com o período de vigência predefinido. Após o upgrade, o Compute Engine muda a data de término do período atual do compromisso em dois anos.

Por exemplo, suponha que seu compromisso de um ano tenha uma data de início de 1º de janeiro de 2024 e uma data de término personalizada de 30 de junho de 2025. O período de qualificação para seu período original de um ano vai permanecer aberto até 1º de maio de 2024. Suponha que você tenha feito upgrade desse compromisso para um de três anos em 1º de abril de 2024. Após o upgrade do período, seu compromisso se torna um compromisso de três anos com data de término em 30 de junho de 2027. O período de qualificação atualizado do compromisso vai permanecer aberto até 1º de janeiro de 2025. Você também vai começar a receber a porcentagem de CUD aplicável ao compromisso de três anos.

Para mais informações sobre como fazer upgrade de compromissos, consulte Fazer upgrade do prazo de compromissos.

Limitações

As limitações a seguir se aplicam às extensões de prazo de compromissos baseados em recursos:

  • Só é possível estender o prazo dos compromissos de recursos de hardware.
  • Não é possível estender o prazo de compromissos inativos ou expirados.
  • Não é possível estender o prazo de um compromisso de três anos por três anos. Em vez disso, considere ativar a renovação automática no seu compromisso.
  • É possível renovar os contratos de período personalizado apenas pelo período predefinido definido pelos planos de compromisso, que são de um ou três anos.
  • Para compromissos ativos que já têm uma solicitação de atualização de compromisso pendente, você só pode fazer uma nova solicitação de extensão de prazo se a solicitação pendente também for para uma extensão de prazo. Se os compromissos tiverem outra solicitação de atualização pendente, como mesclagem, divisão, upgrade de prazo ou atualização da configuração de renovação automática, aguarde até a meia-noite do dia seguinte para que as operações pendentes sejam concluídas e as atualizações entrem em vigor.

Requisitos

Você precisa atender aos seguintes requisitos para estender o período de um compromisso:

  • A solicitação de extensão de prazo precisa ser feita durante o período de qualificação para a extensão de prazo do compromisso.
  • Para compromissos de um ano, a data de término personalizada precisa estar entre 1 e 3 anos (mas não pode ser exatamente 3 anos) a partir da data de início do período atual.
  • Para compromissos de três anos, a data de término personalizada precisa estar entre três e seis anos (mas não pode ser exatamente seis anos) a partir da data de início do período atual.
  • Não é permitido ter outras operações de fusão, divisão, upgrade ou renovação em andamento ou pendentes para esse compromisso.

Práticas recomendadas

O Google recomenda seguir estas práticas recomendadas ao estender o período de um compromisso:

  • Antes de fazer uma solicitação de extensão de prazo, aguarde a conclusão de todas as outras operações de confirmação pendentes e a entrada em vigor das atualizações.
  • Minimize o número de solicitações de extensão de prazo que você faz para um único compromisso no mesmo dia.

Estender o prazo durante a compra de compromisso

Ao comprar um compromisso, você pode especificar uma data de término personalizada para estender o período predefinido de um ou três anos.

Para estender o período de um compromisso durante a compra, use uma das seguintes opções:

Console

Antes de adquirir o compromisso, selecione o projeto que você quer usar para comprar o compromisso no console do Google Cloud. Se o compartilhamento de CUDs estiver ativado para uma conta do Cloud Billing, será possível adquirir o compromisso usando qualquer projeto dessa conta.

  1. No Console do Google Cloud, acesse a página Desconto por compromisso de uso.

    Acesse "Descontos por uso contínuo"

    A página Lista de compromissos é aberta e mostra a guia Compromissos de hardware.

  2. Clique em Comprar compromisso.

    A página Comprar um desconto por compromisso de uso é aberta e mostra a guia Hardware.

  3. No campo Nome, insira um nome para o compromisso.

  4. No campo Região, selecione a região em que você quer usar os recursos do Compute Engine.

  5. No campo Tipo de compromisso, selecione a série da família de máquinas para os recursos do compromisso. As seguintes opções de tipo de compromisso estão disponíveis:

    • A2 com otimização do acelerador para recursos do tipo de máquina A2
    • A3 com otimização para aceleradores para recursos do tipo de máquina A3 Edge e High
    • A3 Mega com otimização para aceleradores para recursos do tipo de máquina A3 Mega
    • C2 com otimização para computação para recursos do tipo de máquina C2
    • C2D com otimização para computação para recursos do tipo de máquina C2D
    • H3 com otimização para computação para recursos de tipo de máquina H3
    • Uso geral C3 para recursos do tipo de máquina C3
    • C3D de uso geral para recursos do tipo de máquina C3D
    • Uso geral C4 para recursos do tipo de máquina C4
    • Uso geral C4A para recursos do tipo de máquina C4A
    • Uso geral E2 para recursos do tipo de máquina E2
    • Uso geral N1 para recursos do tipo de máquina N1
    • Uso geral N2 para recursos do tipo de máquina N2
    • Uso geral N2D para recursos do tipo de máquina N2D
    • Uso geral N4 para recursos do tipo de máquina N4
    • T2D de uso geral para recursos do tipo de máquina Tau T2D
    • G2 com otimização gráfica para recursos do tipo de máquina G2
    • M1/M2 com otimização de memória para recursos dos tipos de máquina M1 e M2
    • M3 com otimização de memória para recursos do tipo de máquina M3
    • Z3 com otimização para armazenamento para recursos do tipo de máquina Z3

  6. Na seção Duração, faça o seguinte:

    1. Para especificar a duração predefinida do compromisso, selecione 1 ano ou 3 anos.
    2. Para especificar uma data de término personalizada para seu compromisso, clique no botão Extender a data de término e, no campo Data, especifique uma data de término personalizada.

  7. No campo Núcleos, insira o número de vCPUs que você quer comprar.

  8. No campo Memória, insira a quantidade de memória em GB que você quer vincular ao compromisso.

  9. Para confirmar a compra de GPUs, na seção GPUs, clique em Adicionar GPU e faça o seguinte:

    1. No campo Tipo de GPU, selecione o tipo de GPU.
    2. No campo Número de GPUs, digite o número de GPUs.
    3. Opcional: se o modelo de GPU for compatível com estações de trabalho virtuais (vWS) NVIDIA RTX para cargas de trabalho de gráficos e você planeja executar cargas de trabalho com muitos gráficos, selecione a caixa de seleção Ativar a estação de trabalho virtual (NVIDIA GRID).

  10. Para se comprometer a comprar discos SSD locais, na seção SSDs locais, clique em Adicionar SSD e, no campo Número de SSDs, especifique o número de discos.

  11. Se você especificou GPUs ou discos SSD locais no seu compromisso, anexe as reservas correspondentes a esses recursos de uma das seguintes maneiras. Repita esta etapa para cada nova reserva que você quer anexar.

    1. Para anexar uma ou mais reservas atuais ao compromisso, no campo Reservas, selecione Anexar reservas atuais e siga as etapas listadas na seção Anexar reservas atuais.
    2. Para criar uma reserva e anexá-la ao compromisso, no campo Reservas, selecione Criar reservas e siga as etapas listadas na seção Criar novas reservas para anexar.

  12. Para concluir a compra do compromisso, faça o seguinte:

    1. Clique em Comprar.
    2. Na caixa de diálogo Comprar um desconto por compromisso de uso, se você concordar com os termos específicos do serviço, clique novamente em Comprar.

gcloud

Para adquirir um compromisso com um período personalizado e estendido, execute o comando gcloud compute commitments create e inclua a flag --custom-end-time.

Por exemplo, para adquirir um compromisso de vCPUs, memória ou ambos, use o seguinte comando:

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=COMMITMENT_PLAN \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --custom-end-time=CUSTOM_END_DATE

Substitua:

  • COMMITMENT_NAME: o nome do compromisso
  • REGION: a região do compromisso e onde você quer comprar recursos do Compute Engine.
  • PROJECT_ID: o ID do projeto

  • COMMITMENT_PLAN: o período mínimo predefinido em que você quer se comprometer a comprar recursos. Especifique um dos seguintes valores:

    • Para um compromisso de um ano: 12-month
    • Para um compromisso de três anos: 36-month.

  • COMMITMENT_TYPE: a série de máquinas para a qual você quer se comprometer a comprar recursos. As seguintes opções estão disponíveis:

    • accelerator-optimized para recursos do tipo de máquina A2
    • accelerator-optimized-a3 para recursos do tipo de máquina A3 Edge e High
    • accelerator-optimized-a3-mega para recursos do tipo de máquina A3 Mega
    • compute-optimized para recursos do tipo de máquina C2
    • compute-optimized-c2d para recursos do tipo de máquina C2D
    • compute-optimized-c3 para recursos do tipo de máquina C3
    • compute-optimized-c3d para recursos do tipo de máquina C3D
    • compute-optimized-h3 para recursos do tipo de máquina H3
    • general-purpose para recursos do tipo de máquina N1
    • general-purpose-c4 para recursos do tipo de máquina C4
    • general-purpose-c4a para recursos do tipo de máquina C4A
    • general-purpose-e2 para recursos do tipo de máquina E2
    • general-purpose-n2 para recursos do tipo de máquina N2
    • general-purpose-n2d para recursos de máquina N2D
    • general-purpose-n4 para recursos do tipo de máquina N4
    • general-purpose-t2d para recursos do tipo de máquina Tau T2D
    • graphics-optimized para recursos do tipo de máquina G2
    • memory-optimized para recursos de tipo de máquina M1 ou M2
    • memory-optimized-m3 para recursos do tipo de máquina M3
    • storage-optimized-z3 para recursos do tipo de máquina Z3

    Se você não especificar a flag --type, o Compute Engine vai usar general-purpose como o valor padrão.

  • NUMBER_VCPUS: o número de vCPUs que você quer adquirir.

  • MEMORY: a quantidade, em MB ou GB, de memória que você quer adquirir, por exemplo, 1000MB ou 100GB. Se você não especificar as unidades, o Compute Engine vai usar GB como a unidade padrão. É possível especificar esse valor em incrementos de 0,25 GB.

  • CUSTOM_END_DATE: a data de término personalizada do seu período, que precisa estar formatada como YYYY-MM-DD. Por exemplo, para especificar uma data de término personalizada de 20 de abril de 2024, formate-a como 2024-04-20.

Para ver a sintaxe detalhada de como estender o período ao comprar um compromisso para GPUs, discos SSD locais ou ambos, consulte Comprar compromissos com reservas anexadas.

Por exemplo, considere um compromisso de um ano chamado example-commitment para quatro vCPUs N1 e 9 GB de memória na região us-central1. Suponha que você queira comprar esse compromisso em 1º de janeiro de 2024 e que queira um período personalizado que termine em 30 de junho de 2025. Para comprar esse compromisso, execute o seguinte comando:

gcloud compute commitments create example-commitment \
    --region=us-central1 \
    --project=my-project
    --plan=12-month \
    --type=general-purpose
    --resources=memory=9GB,vcpu=4 \
    --custom-end-time=2025-07-01

REST

Para comprar um compromisso com um período personalizado e estendido, faça uma solicitação POST ao método regionCommitments.insert. No corpo da solicitação, inclua o campo customEndTimestamp.

Por exemplo, para adquirir um compromisso de vCPUs, memória ou ambos, use o seguinte corpo de solicitação POST:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
    "name": "COMMITMENT_NAME",
    "plan": "COMMITMENT_PLAN",
    "type": "COMMITMENT_TYPE",
    "resources":
    [
        {
            "amount": "NUMBER_VCPUS",
            "type": "VCPU"
        },
        {
            "amount": "MEMORY",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
}

Substitua:

  • COMMITMENT_NAME: o nome do compromisso
  • REGION: a região do compromisso e onde você quer comprar recursos do Compute Engine.
  • PROJECT_ID: o ID do projeto

  • COMMITMENT_PLAN: o período mínimo predefinido em que você quer se comprometer a comprar recursos. Especifique um dos seguintes valores:

    • Para um compromisso de um ano: TWELVE_MONTH
    • Para um compromisso de três anos: THIRTY_SIX_MONTH.

  • COMMITMENT_TYPE: a série de máquinas para a qual você quer se comprometer a comprar recursos. As seguintes opções estão disponíveis:

    • ACCELERATOR_OPTIMIZED para recursos do tipo de máquina A2
    • ACCELERATOR_OPTIMIZED_A3 para recursos do tipo de máquina A3 Edge e High
    • ACCELERATOR_OPTIMIZED_A3_MEGA para recursos do tipo de máquina A3 Mega
    • COMPUTE_OPTIMIZED para recursos do tipo de máquina C2
    • COMPUTE_OPTIMIZED_C2D para recursos do tipo de máquina C2D
    • COMPUTE_OPTIMIZED_C3 para recursos do tipo de máquina C3
    • COMPUTE_OPTIMIZED_C3D para recursos do tipo de máquina C3D
    • COMPUTE_OPTIMIZED_H3 para recursos do tipo de máquina H3
    • GENERAL_PURPOSE para recursos do tipo de máquina N1
    • GENERAL_PURPOSE_C4 para recursos do tipo de máquina C4
    • GENERAL_PURPOSE_C4A para recursos do tipo de máquina C4A
    • GENERAL_PURPOSE_E2 para recursos do tipo de máquina E2
    • GENERAL_PURPOSE_N2 para recursos do tipo de máquina N2
    • GENERAL_PURPOSE_N2D para recursos de máquina N2D
    • GENERAL_PURPOSE_N4 para recursos do tipo de máquina N4
    • GENERAL_PURPOSE_T2D para recursos do tipo de máquina Tau T2D
    • GRAPHICS_OPTIMIZED para recursos do tipo de máquina G2
    • MEMORY_OPTIMIZED para recursos de tipo de máquina M1 ou M2
    • MEMORY_OPTIMIZED_M3 para recursos do tipo de máquina M3
    • STORAGE_OPTIMIZED_Z3 para recursos do tipo de máquina Z3

  • NUMBER_VCPUS: o número de vCPUs que você quer adquirir.

  • MEMORY: a quantidade, em MB, de memória que você quer adquirir (por exemplo, 10240MB). É possível especificar esse valor em incrementos de 256 MB.

  • CUSTOM_END_DATE: a data de término personalizada do seu período, que precisa estar formatada como YYYY-MM-DD. Por exemplo, para especificar uma data de término personalizada de 20 de abril de 2024, formate-a como 2024-04-20.

  • END_TIME: 0h no horário do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7), como um ajuste de Tempo Universal Coordenado (UTC). Especifique um dos seguintes valores:

    • Durante o horário de verão: 07:00:00
    • Em outros horários: 08:00:00

Para ver a sintaxe detalhada de como estender o período ao comprar um compromisso para GPUs, discos SSD locais ou ambos, consulte Comprar compromissos com reservas anexadas.

Por exemplo, considere um compromisso de um ano chamado example-commitment para quatro vCPUs N1 e 9 GB de memória na região us-central1. Suponha que você queira comprar esse compromisso em 1º de janeiro de 2024 e que queira um período personalizado que termine no final de 30 de junho de 2025. Para comprar esse compromisso, faça a seguinte solicitação:

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments
{
    "name": "example-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE",
    "resources":
    [
        {
            "amount": "4",
            "type": "VCPU"
        },
        {
            "amount": "9216",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "2025-07-01T07:00:00Z",
}

Estender o prazo de um compromisso

É possível estender o período atual do compromisso ativo atualizando as propriedades do compromisso para especificar ou atualizar a data de término personalizada.

Para estender o período de um compromisso, use uma das seguintes opções:

Console

Antes de iniciar a operação de extensão do prazo, no console do Google Cloud, selecione o projeto em que você quer estender o prazo do compromisso.

  1. No console do Google Cloud, acesse a página Desconto por compromisso de uso.

    Acesse "Descontos por uso contínuo"

    A página Lista de compromissos é aberta e mostra a guia Compromissos de hardware.

  2. Para iniciar a operação de extensão de prazo de um compromisso, na guia Compromissos de hardware, selecione um compromisso ativo e clique em Estender.

    Como alternativa, faça o seguinte:

    1. Na guia Compromissos de hardware da página Lista de compromissos, clique no nome do compromisso ativo que você quer estender.
    2. Na página Detalhes do compromisso de hardware do compromisso selecionado, clique em Prorrogar.

    O painel Extend aparece para o compromisso selecionado.

  3. Para concluir a operação de extensão do prazo, no painel Extend do compromisso, faça o seguinte:

    1. Revise os detalhes do compromisso.
    2. No campo Selecionar uma data de término, especifique uma data de término personalizada para seu compromisso.
    3. Na seção Cronograma do compromisso, revise o campo Nova data de término.
    4. Para confirmar o pedido de extensão do período, clique em Estender.

gcloud

Para estender o período de um compromisso ativo, execute o comando gcloud compute commitments update e inclua a flag --custom-end-time.

gcloud compute commitments update COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --custom-end-time=CUSTOM_END_DATE

Substitua:

  • COMMITMENT_NAME: o nome do compromisso
  • PROJECT_ID: o ID do projeto
  • REGION: a região do compromisso e onde você quer comprar recursos do Compute Engine.
  • CUSTOM_END_DATE: a data de término personalizada que você quer para o período, no formato YYYY-MM-DD, em que YYYY é o ano, MM é o mês e DD é o dia. Por exemplo, para especificar uma data de término personalizada de 20 de abril de 2024, formate como 2024-04-20.

Por exemplo, considere o compromisso de período personalizado de um ano, example-commitment, que foi comprado para 4 vCPUs N1 e 9 GB de memória na região us-central1. Esse compromisso foi comprado em 1º de janeiro de 2024 e expira em 30 de junho de 2025. Para estender o período até 30 de junho de 2026, execute o seguinte comando:

gcloud compute commitments update example-commitment \
    --region=us-central1 \
    --project=my-project \
    --custom-end-time=2026-07-01

REST

Para estender o período de um compromisso ativo, faça uma solicitação PATCH para o método regionCommitments.update. No corpo da solicitação, inclua o campo customEndTimestamp.

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

Substitua:

  • COMMITMENT_NAME: o nome do compromisso
  • REGION: a região do compromisso e onde você quer comprar recursos do Compute Engine.
  • PROJECT_ID: o ID do projeto
  • CUSTOM_END_DATE: a data de término personalizada que você quer para o período, no formato YYYY-MM-DD, em que YYYY é o ano, MM é o mês e DD é o dia. Por exemplo, para especificar uma data de término personalizada de 20 de abril de 2024, formate como 2024-04-20.

  • END_TIME: 0h no horário do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7), como um ajuste de Tempo Universal Coordenado (UTC). Especifique um dos seguintes valores:

    • Durante o horário de verão: 07:00:00
    • Em outros horários: 08:00:00

Por exemplo, considere o compromisso de período personalizado de um ano, example-commitment, que foi comprado para 4 vCPUs N1 e 9 GB de memória na região us-central1. Esse compromisso foi comprado em 1º de janeiro de 2024 e expira em 30 de junho de 2025. Para estender o período até 30 de junho de 2026, faça a seguinte solicitação:

PATCH https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments/example-commitment
{
    "name": "example-commitment",
    "customEndTimestamp": "2026-07-01T07:00:00Z",
}

A seguir