Estender os prazos de compromisso

Neste documento, mostramos como estender o prazo dos seus compromissos com base em recursos de hardware do Compute Engine além das opções predefinidas de um e três anos.

As extensões de prazo oferecem a flexibilidade de estender o prazo de um compromisso além do predefinido de 1 ou 3 anos e especificar uma duração personalizada de sua escolha, por exemplo, 2, 3,5 ou 5,5 anos. Ao estender o prazo do seu compromisso, é possível adaptá-lo para atender às suas necessidades de uso de recursos e continuar recebendo os descontos por compromisso de uso (CUDs) resultantes por essa duração mais longa e personalizada. É possível estender os termos dos compromissos de 1 e 3 anos da seguinte maneira:

  • Compromissos de 1 ano: é possível especificar durações de vigência personalizadas maiores que 1 ano e menores que 3 anos.
  • Compromissos de 3 anos: é possível especificar durações de vigência personalizadas maiores que 3 anos e menores que 6 anos.

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

Como funciona a extensão de prazo

Um compromisso fica ativo por um período específico, definido pelas datas de início e término, conhecido como prazo. Se um compromisso tiver a renovação automática ativada, ele vai iniciar um novo período sempre que for renovado. Ao realizar uma extensão de prazo, você modifica a data de término apenas do prazo em andamento do compromisso, ou seja, o prazo que está ativo quando você solicita a extensão.

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

É possível estender o prazo de compromissos novos e atuais da seguinte maneira:

Depois que você fizer uma solicitação de extensão de prazo para seu compromisso, as mudanças vão entrar em vigor à 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. Seu compromisso vai continuar ativo até a nova data de término personalizada, e o prazo será ajustado de acordo. A extensão do prazo do compromisso não afeta as outras propriedades dele:

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

A extensão do prazo do compromisso não altera a taxa de CUD que você recebe em troca desse compromisso.

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

Período de qualificação para extensão do prazo

Depois que o período de um compromisso começa, você tem um tempo limitado para solicitar uma extensão. Esse período é chamado de janela de qualificação para extensão do prazo.

Independentemente de o compromisso ter uma duração predefinida ou personalizada, a janela de qualificação para extensão do prazo depende da operação mais recente que você realizou no compromisso. Dependendo da operação, a janela de qualificação para extensão de prazo se aplica das seguintes maneiras:

  • Compromissos recém-adquiridos: para compromissos de um ano, a janela de qualificação permanece aberta por 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 por um novo período, a janela de qualificação será atualizada no início do período renovado. Para compromissos de um ano, a janela de qualificação permanece aberta por até quatro 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 termina primeiro para o compromisso mesclado.

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

  • 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 em andamento.

    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 para o prazo original de um ano permanece aberto até 1º de maio de 2024. Suponha que você tenha feito upgrade desse compromisso para um compromisso de três anos em 1º de abril de 2024. Após o upgrade, a janela de qualificação atualizada do compromisso vai permanecer aberta até 1º de janeiro de 2025.

Como realizar várias extensões de prazo

É possível estender o prazo do compromisso quantas vezes quiser dentro da janela de qualificação para extensão de prazo. Em qualquer dia, para qualquer compromisso ativo, é possível fazer várias solicitações de extensão de prazo até as 0h (horário do Canadá: 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 seu compromisso tiver uma nova data de término personalizada, não será possível desfazer a extensão de vigência ou reduzir a duração da vigência do compromisso. Só é possível realizar operações de extensão subsequentes para datas de término posteriores à data de término especificada mais recentemente.

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

Para compromissos ativos que já têm uma solicitação de atualização pendente, é possível fazer uma nova solicitação de extensão de prazo somente se a solicitação pendente também for para uma extensão de prazo. Se os compromissos tiverem solicitações de atualização pendentes, como mesclagem, divisão, upgrade ou atualização da configuração de renovação automática, para solicitar extensões de prazo, aguarde a conclusão das operações pendentes e a aplicação das atualizações. Após as 0h (horário do Pacífico dos EUA e do Canadá: UTC-8 ou UTC-7) do dia seguinte, quando as atualizações entrarem em vigor, será possível solicitar uma extensão de 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 prazo 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 preços de recursos, consulte Preços do Compute Engine.

Considerações de cota

Para especificar uma data de término personalizada ao comprar 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 uma cota adicional.

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

Se o compromisso tiver uma duração personalizada, qualquer operação de gerenciamento subsequente poderá afetar a data de término personalizada e a janela de qualificação. As seções a seguir explicam como um compromisso de prazo personalizado se comporta durante outras operações de compromisso:

Compromissos de prazo personalizado com renovação automática

A duração do período renovado de um compromisso com renovação automática sempre corresponde à duração predefinida pelo plano do compromisso, que é de 1 ou 3 anos. Você também recebe a mesma porcentagem de desconto. Mesmo que seu compromisso tenha uma duração personalizada, o Compute Engine só o renovará pela duração predefinida de um ou três anos. A renovação automática de um compromisso de prazo personalizado não será para outro prazo com essa duração personalizada. Veja exemplos:

  • Um compromisso com um prazo personalizado de 1,5 ano será renovado por apenas mais 1 ano.
  • Um compromisso com um prazo personalizado de 5,5 anos será renovado por apenas mais 3 anos.

Se você quiser que um compromisso de prazo personalizado permaneça ativo por um período mais longo do que o prazo renovado, solicite outra extensão de prazo após a renovação. O período de qualificação para extensão do prazo também é atualizado no início do prazo 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 3 anos, essa janela permanece aberta por até 1 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 de 2024. Você estende o prazo desse compromisso e especifica uma data de término personalizada de 30 de junho de 2025. Se você também tiver ativado a renovação automática no seu compromisso, em 1º de julho de 2025, ele será renovado por mais um ano. A data de término do período renovado será 30 de junho de 2026. A janela de qualificação para extensão de prazo durante esse período renovado permanece aberta 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 personalizado

As operações de mesclagem se comportam da mesma forma para compromissos com durações de vigência personalizadas e predefinidas. O compromisso mesclado herda as seguintes propriedades:

  • A data de término mais distante no futuro entre os compromissos de origem, independentemente de ser uma data de término personalizada.
  • A janela de qualificação que termina mais cedo entre os compromissos de origem.

Por exemplo, digamos que você queira mesclar dois contratos personalizados de um ano. O primeiro compromisso tem uma data de início em 1º de janeiro de 2024 e uma data de término personalizada em 30 de junho de 2025. A janela de qualificação para o primeiro compromisso permanece aberta até 1º de maio de 2024. O segundo compromisso tem uma data de início em 1º de fevereiro de 2024 e uma data de término personalizada em 30 de julho de 2025. O período de qualificação para o segundo compromisso permanece aberto 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 de término. A janela de qualificação para o compromisso mesclado permanece aberta até 1º de maio de 2024.

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

Como dividir compromissos de prazo personalizado

As operações de divisão se comportam da mesma forma para compromissos com durações de prazo personalizadas e predefinidas. 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 de prazo.

Por exemplo, suponha que a data de início do seu compromisso de um ano seja 1º de janeiro de 2024 e tenha uma data de término personalizada de 30 de junho de 2025. O período de qualificação para seu compromisso permanece aberto até 1º de maio de 2024. Suponha que, em 1º de março de 2024, você divida esse compromisso em dois compromissos separados. Os compromissos recém-divididos herdam a data de término personalizada de 30 de junho de 2025, e as janelas de qualificação permanecem abertas até 1º de maio de 2024.

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

Como fazer upgrade de compromissos de prazo personalizado

É possível fazer upgrade de compromissos de 1 ano com durações personalizadas. Isso funciona da mesma forma que o upgrade de compromissos com durações de prazo predefinidas. Quando você faz upgrade de um compromisso de um ano com uma duração de vigência personalizada, o Compute Engine faz o seguinte:

  • Muda o plano do compromisso para 3 anos
  • Muda a data de término do período em andamento do compromisso em dois anos para o futuro.

Por exemplo, suponha que seu compromisso de um ano tenha uma data de início em 1º de janeiro de 2024 e uma data de término personalizada em 30 de junho de 2025. O período de qualificação para seu contrato original de um ano permanece aberto até 1º de maio de 2024. Se você fizer upgrade desse compromisso em 1º de abril de 2024, ele será alterado para um compromisso de três anos com data de término em 30 de junho de 2027. A janela de qualificação atualizada do compromisso permanece aberta até 1º de janeiro de 2025. Você também começa a receber a taxa de CUD aplicável a um compromisso de três anos.

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

Limitações

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

  • Só é possível estender os termos de compromissos de recursos de hardware.
  • Não é possível estender os termos de compromissos inativos ou expirados.
  • Não é possível estender os termos de compromissos adquiridos por meio de reservas adiantadas no Hipercomputador de IA ou reservas adiantadas para Cloud TPUs.
  • Para compromissos de 1 ano, não é possível especificar uma data de término personalizada que resulte em um período total de compromisso de 3 anos ou mais. Em vez disso, considere mudar o plano do seu compromisso de um ano para três anos fazendo upgrade do compromisso.
  • Para compromissos de 3 anos, não é possível especificar uma data de término personalizada que resulte em um período total de compromisso de 6 anos ou mais. Em vez disso, ative a renovação automática no seu compromisso. A renovação automática permite que seu compromisso seja renovado por mais um período de 3 anos completos.
  • Quando um compromisso de prazo personalizado é renovado, o novo prazo tem a duração de um ou três anos definida pelo plano do compromisso, em vez da duração personalizada.
  • Para compromissos ativos que já têm uma solicitação de atualização de compromisso pendente, só é possível 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 outras solicitações de atualização pendentes, como mesclagem, divisão, upgrade ou atualização da configuração de renovação automática, para solicitar extensões de prazo, aguarde até depois da 0h (horário do Pacífico dos EUA e do Canadá: UTC-8 ou UTC-7) no dia seguinte para que as operações pendentes sejam concluídas e as atualizações entrem em vigor.

Requisitos

Para estender o prazo de um compromisso, você precisa atender aos seguintes requisitos:

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

Práticas recomendadas

O Google recomenda que você siga estas práticas recomendadas ao estender o prazo 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 compromisso pendentes e a aplicação 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 ao comprar o compromisso

Ao comprar um compromisso, é possível especificar uma data de término personalizada para estender o período predefinido de 1 ou 3 anos.

Para comprar um compromisso com uma duração estendida, siga estas etapas:

Console

Antes de comprar o compromisso, no console do Google Cloud , selecione o projeto que você quer usar para comprar o compromisso. 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 Descontos por compromisso de uso.

    Acesse "Descontos por compromisso de uso"

  2. Clique em Comprar compromisso. A página Comprar um compromisso é exibida.

  3. Na página Comprar um compromisso, especifique as propriedades do seu compromisso, da seguinte maneira:

    1. Para configurar uma extensão de prazo para seu compromisso, na seção Prazo, faça o seguinte:

      1. Especifique o plano para seu compromisso selecionando 1 ano ou 3 anos. O plano determina a taxa de CUD e a duração predefinida do seu compromisso.

      2. Revise o campo Data de início, que mostra a data e a hora em que o compromisso se torna ativo. Esse campo é definido automaticamente como 0h (horário do Pacífico dos EUA e do Canadá) no dia seguinte à data atual.

      3. Para especificar uma data de término personalizada para seu compromisso, no campo Data de término, especifique a data desejada.

    2. Para instruções sobre como configurar outras propriedades para seu compromisso, consulte uma das seguintes páginas, dependendo do seu caso de uso:

      No mínimo, é preciso especificar o nome, a região, os recursos, o tipo de compromisso e o plano de compromisso.

  4. No painel Resumo à direita, revise os detalhes do compromisso e as possíveis limitações de cota.

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

    1. Navegue até a parte de baixo da página.

    2. Leia a seção Declarações, que contém informações sobre taxas, qualificação para descontos e Termos e Condições.

    3. Para confirmar que você aceita o preço do compromisso e os termos específicos do serviço, marque a caixa de seleção.

    4. Clique em Comprar.

gcloud

Para adquirir um compromisso com uma vigência personalizada e estendida, 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 se comprometer a comprar recursos do Compute Engine.
  • PROJECT_ID: o ID do projeto

  • COMMITMENT_PLAN: o plano de compromisso. Essa propriedade também determina a duração mínima do compromisso de compra de recursos. Especifique um dos seguintes valores:

    • Para um compromisso de 1 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:

    • Para tipos de máquina A2, use accelerator-optimized
    • Para os tipos de máquina A3 Edge e A3 High, use accelerator-optimized-a3
    • Para tipos de máquina A3 Mega, use accelerator-optimized-a3-mega
    • Para tipos de máquina G2, use graphics-optimized
    • Para tipos de máquina G4, use graphics-optimized-g4
    • Para tipos de máquina C2, use compute-optimized
    • Para tipos de máquina C2D, use compute-optimized-c2d
    • Para tipos de máquina C3, use compute-optimized-c3
    • Para tipos de máquina C3D, use compute-optimized-c3d
    • Para tipos de máquina H3, use compute-optimized-h3
    • Para tipos de máquina H4D, use compute-optimized-h4d
    • Para tipos de máquina N1, use general-purpose
    • Para tipos de máquina C4, use general-purpose-c4
    • Para tipos de máquina C4A, use general-purpose-c4a
    • Para tipos de máquina C4D, use general-purpose-c4d
    • Para tipos de máquina C4N, use network-optimized-c4n
    • Para tipos de máquina E2, use general-purpose-e2
    • Para tipos de máquinas N2, use general-purpose-n2
    • Para tipos de máquina N2D, use general-purpose-n2d
    • Para tipos de máquina N4, use general-purpose-n4
    • Para tipos de máquina N4D, use general-purpose-n4d
    • Para tipos de máquina N4A, use general-purpose-n4a
    • Para tipos de máquina Tau T2D, use general-purpose-t2d
    • Para tipos de máquina M1 ou M2, use memory-optimized
    • Para tipos de máquina M3, use memory-optimized-m3
    • Para tipos de máquina M4 com 6 TB de memória, use memory-optimized-m4-6tb
    • Para outros tipos de máquina M4, use memory-optimized-m4
    • Para tipos de máquina X4 com 6 TB de memória, use memory-optimized-x4-6t
    • Para tipos de máquina X4 com 8 TB de memória, use memory-optimized-x4-8t
    • Para tipos de máquina X4 com 12 TB de memória, use memory-optimized-x4-12t
    • Para tipos de máquina X4 com 16 TB de memória, use memory-optimized-x4-960-16t
    • Para tipos de máquina X4 com 24 TB de memória, use memory-optimized-x4-1440-24t
    • Para tipos de máquina X4 com 32 TB de memória, use memory-optimized-x4-1920-32t
    • Para tipos de máquina Z3, use storage-optimized-z3
    • Para tipos de máquina Z4D, use storage-optimized-z4d
    • Para tipos de máquina Z4M, use storage-optimized-z4m

    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 se comprometer a comprar.

  • MEMORY: a quantidade, em MB ou GB, de memória que você quer se comprometer a comprar, por exemplo, 1000MB ou 100GB. Se você não especificar as unidades, o Compute Engine usará GB como a unidade padrão.

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

Para ver a sintaxe detalhada de como estender o prazo ao comprar um compromisso para GPUs, discos SSD locais ou ambos, consulte Comprar compromissos baseados em recursos de hardware com reservas anexadas.

Por exemplo, considere um compromisso (example-commitment) na região us-central1 com recursos especificados como quatro vCPUs N1 e 9 GB de memória. O plano de compromisso é 12-month. Suponha que você queira comprar esse compromisso em 1º de janeiro de 2024 e queira um prazo 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 uma vigência personalizada e estendida, 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 para 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 se comprometer a comprar recursos do Compute Engine.
  • PROJECT_ID: o ID do projeto

  • COMMITMENT_PLAN: o plano de compromisso. Essa propriedade também determina a duração mínima do compromisso de compra de recursos. Especifique um dos seguintes valores:

    • Para um compromisso de 1 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:

    • Para tipos de máquina A2, use ACCELERATOR_OPTIMIZED
    • Para os tipos de máquina A3 Edge e A3 High, use ACCELERATOR_OPTIMIZED_A3
    • Para tipos de máquina A3 Mega, use ACCELERATOR_OPTIMIZED_A3_MEGA
    • Para tipos de máquina G2, use GRAPHICS_OPTIMIZED
    • Para tipos de máquina G4, use GRAPHICS_OPTIMIZED_G4
    • Para tipos de máquina C2, use COMPUTE_OPTIMIZED
    • Para tipos de máquina C2D, use COMPUTE_OPTIMIZED_C2D
    • Para tipos de máquina C3, use COMPUTE_OPTIMIZED_C3
    • Para tipos de máquina C3D, use COMPUTE_OPTIMIZED_C3D
    • Para tipos de máquina H3, use COMPUTE_OPTIMIZED_H3
    • Para tipos de máquina H4D, use COMPUTE_OPTIMIZED_H4D
    • Para tipos de máquina N1, use GENERAL_PURPOSE
    • Para tipos de máquina C4, use GENERAL_PURPOSE_C4
    • Para tipos de máquina C4A, use GENERAL_PURPOSE_C4A
    • Para tipos de máquina C4D, use GENERAL_PURPOSE_C4D
    • Para tipos de máquina C4N, use NETWORK_OPTIMIZED_C4N
    • Para tipos de máquina E2, use GENERAL_PURPOSE_E2
    • Para tipos de máquinas N2, use GENERAL_PURPOSE_N2
    • Para tipos de máquina N2D, use GENERAL_PURPOSE_N2D
    • Para tipos de máquina N4, use GENERAL_PURPOSE_N4
    • Para tipos de máquina N4D, use GENERAL_PURPOSE_N4D
    • Para tipos de máquina N4A, use GENERAL_PURPOSE_N4A
    • Para tipos de máquina Tau T2D, use GENERAL_PURPOSE_T2D
    • Para tipos de máquina M1 ou M2, use MEMORY_OPTIMIZED
    • Para tipos de máquina M3, use MEMORY_OPTIMIZED_M3
    • Para tipos de máquina M4 com 6 TB de memória, use MEMORY_OPTIMIZED_M4_6TB
    • Para outros tipos de máquina M4, use MEMORY_OPTIMIZED_M4
    • Para tipos de máquina X4 com 6 TB de memória, use MEMORY_OPTIMIZED_X4_480_6T
    • Para tipos de máquina X4 com 8 TB de memória, use MEMORY_OPTIMIZED_X4_480_8T
    • Para tipos de máquina X4 com 12 TB de memória, use MEMORY_OPTIMIZED_X4_960_12T
    • Para tipos de máquina X4 com 16 TB de memória, use MEMORY_OPTIMIZED_X4_960_16T
    • Para tipos de máquina X4 com 24 TB de memória, use MEMORY_OPTIMIZED_X4_1440_24T
    • Para tipos de máquina X4 com 32 TB de memória, use MEMORY_OPTIMIZED_X4_1920_32T
    • Para tipos de máquina Z3, use STORAGE_OPTIMIZED_Z3
    • Para tipos de máquina Z4D, use STORAGE_OPTIMIZED_Z4D
    • Para tipos de máquina Z4M, use STORAGE_OPTIMIZED_Z4M

  • NUMBER_VCPUS: o número de vCPUs que você quer se comprometer a comprar.

  • MEMORY: a quantidade, em MB, de memória que você quer se comprometer a comprar, por exemplo, 10240MB.

  • CUSTOM_END_DATE: a data de término personalizada do período, que precisa ser formatada como YYYY-MM-DD. Por exemplo, para especificar uma data de término personalizada de 20 de abril de 2024, use o formato 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 do 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 prazo ao comprar um compromisso para GPUs, discos SSD locais ou ambos, consulte Comprar compromissos baseados em recursos de hardware com reservas anexadas.

Por exemplo, considere um compromisso (example-commitment) na região us-central1 com recursos especificados como quatro vCPUs N1 e 9 GB de memória. O plano de compromisso é TWELVE_MONTH. Suponha que você queira comprar esse compromisso em 1º de janeiro de 2024 e queira um prazo 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 atual

É possível estender o prazo de um compromisso ativo atualizando as propriedades dele para especificar ou atualizar a data de término personalizada.

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

Console

Antes de iniciar a operação de extensão de 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 Descontos por compromisso de uso.

    Acesse "Descontos por compromisso de uso"

    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, você pode fazer 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 Estender.

    O painel Estender é exibido para o compromisso selecionado.

  3. Para concluir a operação de extensão de prazo, no painel Estender 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 Linha do tempo do compromisso, revise o campo Nova data de término.

    4. Para confirmar o pedido de extensão do prazo, clique em Estender.

gcloud

Para estender o prazo 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 se comprometer a 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, use o formato 2024-04-20.

Por exemplo, considere um compromisso de prazo personalizado (example-commitment) na região us-central1 com recursos especificados como quatro vCPUs N1 e nove GB de memória. O plano de compromisso é 12-month. Esse compromisso foi adquirido em 1º de janeiro de 2024 e expira em 30 de junho de 2025. Para estender o prazo até o final de 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 prazo de um compromisso ativo, faça uma solicitação PATCH ao 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 se comprometer a 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, use o formato 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 do 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 um compromisso de prazo personalizado (example-commitment) na região us-central1 com recursos especificados como quatro vCPUs N1 e nove GB de memória. O plano de compromisso é 12-month. Esse compromisso foi adquirido em 1º de janeiro de 2024 e expira em 30 de junho de 2025. Para estender o prazo até o final de 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