Prolongue a duração dos compromissos

Este documento fornece informações sobre a extensão da duração dos seus compromissos baseados em recursos de hardware do Compute Engine para além das opções predefinidas de 1 e 3 anos.

As extensões de prazo dão-lhe a flexibilidade de prolongar a duração do prazo de um compromisso para além dos 1 ou 3 anos predefinidos e especificar uma duração do prazo personalizada à sua escolha, por exemplo, 2, 3,5 ou 5,5 anos. Ao prolongar o prazo do compromisso, pode adaptá-lo às suas necessidades de utilização de recursos e continuar a receber os descontos por utilização garantida (CUDs) resultantes durante esse período personalizado mais longo. Pode prolongar os prazos dos compromissos de 1 ano e 3 anos da seguinte forma:

  • Compromissos de 1 ano: pode especificar durações personalizadas que sejam superiores a 1 ano e inferiores a 3 anos.
  • Compromissos de 3 anos: pode especificar durações personalizadas que sejam superiores a 3 anos e inferiores a 6 anos.

Para outras formas de manter os seus compromissos ativos durante mais tempo, consulte as seguintes alternativas:

Como funciona a extensão do prazo

Pode prolongar a duração do compromisso e definir uma duração personalizada especificando uma data de fim futura à sua escolha para a duração desse compromisso. O seu compromisso torna-se um compromisso de prazo personalizado. Para compromissos de 1 ano, a data de fim personalizada pode estar entre 1 e 3 anos (mas não pode ser exatamente 3 anos) após a data de início do prazo em curso. Para compromissos de 3 anos, a data de fim personalizada pode estar entre 3 e 6 anos (mas não pode ser exatamente 6 anos) após a data de início do prazo em curso.

Pode fazer uma extensão do prazo para compromissos novos e existentes da seguinte forma:

Depois de enviar um pedido de extensão do prazo do compromisso, as alterações entram em vigor às 12:00, hora do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7 durante a mudança de hora). O seu compromisso permanece ativo até à nova data de conclusão personalizada, e a duração do compromisso é ajustada em conformidade. A extensão da duração do compromisso não afeta as outras propriedades do compromisso:

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

A extensão da duração do compromisso não altera a percentagem do CUD que recebe em troca desse compromisso.

Todas as reservas associadas ao seu compromisso continuam a existir durante o período prolongado, a menos que as substitua manualmente.

Período de elegibilidade para a extensão do prazo

Após o início do prazo de um compromisso, tem um período limitado durante o qual pode pedir uma extensão da duração do prazo. Este período denomina-se período de elegibilidade para a extensão do prazo.

Para compromissos com durações predefinidas e personalizadas, o período de elegibilidade para a extensão do prazo depende da operação mais recente que realizou num compromisso e tem o seguinte comportamento:

  • Compromissos recém-comprados: para compromissos de 1 ano, a janela de elegibilidade permanece aberta até 4 meses após a ativação do compromisso. Para compromissos de 3 anos, o período de elegibilidade permanece aberto até 1 ano após a ativação do compromisso.

  • Compromissos de renovação automática: se o seu compromisso for renovado automaticamente por um novo prazo, o período de elegibilidade é atualizado no início do prazo renovado. Para compromissos de 1 ano, o período de elegibilidade permanece aberto até 4 meses após o início do prazo renovado. Para compromissos de 3 anos, o período de elegibilidade permanece aberto até 1 ano após o início do prazo renovado.

  • Compromissos unidos: se unir compromissos com diferentes períodos de elegibilidade, o Compute Engine usa o período de elegibilidade que termina mais cedo para o compromisso unido.

  • Dividir compromissos: quando divide um compromisso, o período de elegibilidade permanece o mesmo para o compromisso de origem redimensionado e o novo compromisso dividido.

  • Alocações atualizadas: quando atualiza uma alocação de 1 ano para uma alocação de 3 anos, o Compute Engine também atualiza o período de elegibilidade da alocação. A janela atualizada permanece aberta até 1 ano a partir do início do prazo em curso.

    Por exemplo, suponhamos que a data de início do seu compromisso de 1 ano é 1 de janeiro de 2024. O período de elegibilidade do seu prazo original de 1 ano permanece aberto até 1 de maio de 2024. Suponhamos que atualizou este compromisso para um compromisso de 3 anos a 1 de abril de 2024. Após a atualização do prazo, o período de elegibilidade atualizado do seu compromisso permanece aberto até 1 de janeiro de 2025.

Realizar várias extensões de termos

Pode prolongar a duração do compromisso em qualquer altura dentro do período de elegibilidade para a extensão do prazo. Em qualquer dia, para qualquer compromisso ativo, pode fazer vários pedidos de extensão do prazo até às 12:00 (hora do Pacífico dos EUA e do Canadá) do dia seguinte (UTC-8 ou UTC-7), desde que especifique uma data de fim posterior em cada pedido. No entanto, a Google recomenda que minimize o número de pedidos de extensão do prazo que faz para um único compromisso num determinado dia.

Depois de a extensão do prazo para uma data de conclusão específica entrar em vigor e o seu compromisso ter uma nova data de conclusão personalizada, não pode anular a extensão do prazo nem reduzir a duração do prazo do compromisso. Só pode realizar operações de extensão subsequentes para datas de conclusão posteriores à data de conclusão especificada mais recentemente.

Impacto dos pedidos de atualização de compromisso pendentes

Para compromissos ativos existentes que já tenham um pedido de atualização pendente, só pode fazer um novo pedido de extensão do prazo se o pedido pendente também for para uma extensão do prazo. Se os compromissos tiverem algum pedido de atualização pendente, como uma união, uma divisão, uma atualização de prazo ou uma atualização da definição de renovação automática, para pedir extensões de prazo, tem de aguardar a conclusão das operações pendentes e que as atualizações entrem em vigor. Após a meia-noite do dia seguinte, quando as atualizações entrarem em vigor, pode pedir uma extensão do prazo para esse compromisso.

Implicações de preços

A taxa de compromisso é a soma dos preços com desconto de todos os seus recursos comprometidos. Quando prolonga a duração do compromisso, os preços com desconto dos recursos permanecem os mesmos durante toda a duração personalizada, mesmo que os preços a pedido mudem. Para mais informações sobre os preços dos recursos, consulte os preços do Compute Engine

Considerações sobre quotas

Para especificar uma data de fim personalizada ao comprar um compromisso, tem de ter quota suficiente disponível para o compromisso e os recursos comprometidos. Normalmente, não precisa de pedir quota adicional para especificar uma data de fim personalizada para um compromisso existente.

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

Se o seu compromisso tiver uma duração personalizada, a realização de quaisquer operações de gestão de compromissos subsequentes no seu compromisso de duração personalizada pode afetar a respetiva data de fim personalizada e período de elegibilidade. As secções seguintes explicam o comportamento de um compromisso de prazo personalizado durante outras operações de compromisso:

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

A duração do prazo renovado de um compromisso de renovação automática corresponde sempre à duração do prazo predefinido definida pelo plano do compromisso, que é de 1 ano ou 3 anos. Também recebe a mesma percentagem de desconto. Mesmo que o seu compromisso tenha uma duração personalizada, o Compute Engine renova o compromisso apenas pela duração predefinida de 1 ou 3 anos. A renovação automática de um compromisso de período personalizado não é feita por outro período com essa duração personalizada. Para ver exemplos, consulte o seguinte:

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

Se quiser que um compromisso de prazo personalizado permaneça ativo durante um período mais longo do que o prazo renovado, pode pedir outra extensão do prazo após a respetiva renovação. O período de elegibilidade para a extensão do prazo também é atualizado no início do prazo renovado. Para um compromisso de 1 ano, o período de elegibilidade durante o prazo renovado permanece aberto até 4 meses após a renovação. Para compromissos de 3 anos, este período permanece aberto até 1 ano após a renovação.

Por exemplo, suponhamos que a data de início do seu compromisso de 1 ano foi 1 de janeiro de 2024. Prolonga o prazo deste compromisso e especifica uma data de fim personalizada de 30 de junho de 2025. Se também ativou a renovação automática do seu compromisso, a 1 de julho de 2025, o compromisso é renovado por mais 1 ano. A data de conclusão do período renovado é 30 de junho de 2026. O período de elegibilidade para a extensão do prazo durante esse prazo renovado permanece aberto até 1 de novembro de 2025.

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

Unir compromissos de termos personalizados

A união de compromissos com durações personalizadas funciona da mesma forma que os compromissos com durações predefinidas. O compromisso unido herda as seguintes propriedades:

  • A data de fim mais distante no futuro entre os compromissos de origem, independentemente de ser uma data de fim personalizada ou não.
  • O período de elegibilidade que termina mais cedo entre os compromissos de origem.

Por exemplo, suponha que quer unir dois compromissos personalizados de 1 ano. O primeiro compromisso tem uma data de início de 1 de janeiro de 2024 e uma data de fim personalizada de 30 de junho de 2025. O período de elegibilidade para o primeiro compromisso permanece 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 fim personalizada de 30 de julho de 2025. O período de elegibilidade para o segundo compromisso permanece aberto até 1 de junho de 2024. Se unir estes compromissos a 1 de abril de 2024, o compromisso unido herda 30 de julho de 2025 como data de fim. O período de elegibilidade para o compromisso unificado permanece aberto até 1 de maio de 2024.

Para mais informações sobre a união de compromissos, consulte o artigo Unir compromissos.

Dividir compromissos de termos personalizados

A divisão de compromissos com uma duração personalizada funciona da mesma forma que os compromissos com durações predefinidas. O compromisso de origem redimensionado e os novos compromissos divididos mantêm a mesma data de fim personalizada e o mesmo período de elegibilidade para extensão do prazo.

Por exemplo, suponhamos que a data de início do seu compromisso de 1 ano é 1 de janeiro de 2024 e tem uma data de fim personalizada de 30 de junho de 2025. O período de elegibilidade para o seu compromisso permanece aberto até 1 de maio de 2024. Suponhamos que, a 1 de março de 2024, divide este compromisso em dois compromissos separados. Os compromissos recém-divididos herdam a data de fim personalizada de 30 de junho de 2025, e as respetivas janelas de elegibilidade permanecem abertas até 1 de maio de 2024.

Para mais informações sobre a divisão de compromissos, consulte o artigo Dividir compromissos.

Atualizar consolidações de prazos personalizados

A atualização de compromissos de 1 ano com uma duração personalizada funciona da mesma forma que os compromissos com a duração predefinida. Após a atualização, o Compute Engine move a data de fim do prazo em curso do compromisso dois anos para o futuro.

Por exemplo, suponhamos que o seu compromisso de 1 ano tem uma data de início de 1 de janeiro de 2024 e uma data de fim personalizada de 30 de junho de 2025. O período de elegibilidade do seu prazo original de 1 ano permanece aberto até 1 de maio de 2024. Suponhamos que, a 1 de abril de 2024, atualizou este compromisso para um compromisso de 3 anos. Após a atualização do prazo, o seu compromisso passa a ser um compromisso de 3 anos com a data de fim de 30 de junho de 2027. O período de elegibilidade atualizado do compromisso permanece aberto até 1 de janeiro de 2025. Também começa a receber a percentagem do CUD aplicável ao compromisso de 3 anos.

Para mais informações sobre a atualização de compromissos, consulte o artigo Atualize o prazo dos compromissos.

Limitações

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

  • Só pode prolongar os prazos dos compromissos de recursos de hardware.
  • Não pode prolongar os prazos de compromissos inativos ou expirados.
  • Não pode prolongar os prazos de um compromisso de 3 anos por mais 3 anos completos. Em alternativa, considere ativar a renovação automática no seu compromisso.
  • Só pode renovar compromissos de prazo personalizado para o período predefinido definido pelos respetivos planos de compromisso, que é de 1 ou 3 anos.
  • Para compromissos ativos existentes que já tenham um pedido de atualização de compromisso pendente, só pode fazer um novo pedido de extensão do prazo se o pedido pendente também for para uma extensão do prazo. Se os compromissos tiverem outro pedido de atualização pendente, como uma união, uma divisão, uma atualização de prazo ou uma atualização da definição de renovação automática, para pedir extensões de prazo, tem de aguardar até depois da meia-noite do dia seguinte para que as operações pendentes sejam concluídas e as atualizações entrem em vigor.

Requisitos

Tem de cumprir os seguintes requisitos para prolongar com êxito a duração de um compromisso:

  • O pedido de extensão do prazo tem de ser feito durante o período de elegibilidade para a extensão do prazo do compromisso.
  • Para compromissos de 1 ano, a data de conclusão personalizada tem de estar entre 1 e 3 anos (mas não pode ser exatamente 3 anos) no futuro a partir da data de início do prazo em curso.
  • Para compromissos de 3 anos, a data de conclusão personalizada tem de estar entre 3 e 6 anos (mas não pode ser exatamente 6 anos) no futuro a partir da data de início do prazo em curso.
  • Não pode ter outras operações de união, divisão, atualização ou renovação em curso ou pendentes para esse compromisso.

Práticas recomendadas

A Google recomenda que siga estas práticas recomendadas quando prolongar a duração do prazo de um compromisso:

  • Antes de enviar um pedido de extensão do prazo, aguarde que todas as outras operações de compromisso pendentes sejam concluídas e que as atualizações entrem em vigor.
  • Minimize o número de pedidos de extensão de prazo que faz para um único compromisso no mesmo dia.

Prolongue a duração do prazo durante a compra do compromisso

Quando compra um compromisso, pode especificar uma data de fim personalizada para prolongar a duração predefinida de 1 ou 3 anos.

Para prolongar a duração de um compromisso durante a compra, use uma das seguintes opções:

Consola

Antes de comprar o compromisso, na Google Cloud consola, selecione o projeto que quer usar para comprar o compromisso. Se a partilha de CUDs estiver ativada para uma conta do Cloud Billing, pode comprar o compromisso usando qualquer projeto dessa conta do Cloud Billing.

  1. Na Google Cloud consola, aceda à página Descontos por utilização comprometida.

    Aceda a Descontos de fidelidade

    É apresentada a página Lista de compromissos, que mostra o separador Compromissos de hardware.

  2. Clique em Compromisso de compra.

    É apresentada a página Comprar um desconto por utilização garantida, que mostra o separador Hardware.

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

  4. No campo Região, selecione a região onde quer comprometer-se a comprar recursos do Compute Engine.

  5. No campo Tipo de compromisso, selecione a série de famílias de máquinas para os seus recursos comprometidos. Estão disponíveis as seguintes opções de tipo de compromisso:

    • Para os tipos de máquinas A2, selecione A2 otimizado para acelerador
    • Para os tipos de máquinas A3 Edge e A3 High, selecione A3 otimizado para aceleradores
    • Para os tipos de máquinas A3 Mega, selecione A3 Mega otimizado para aceleradores
    • Para os tipos de máquinas C2, selecione C2 otimizada para computação
    • Para tipos de máquinas C2D, selecione C2D otimizada para computação
    • Para os tipos de máquinas H3, selecione H3 otimizado para computação
    • Para os tipos de máquinas C3, selecione Utilização geral C3
    • Para os tipos de máquinas C3D, selecione C3D de uso geral
    • Para os tipos de máquinas C4, selecione C4 de utilização geral
    • Para os tipos de máquinas C4A, selecione C4A de utilização geral
    • Para tipos de máquinas C4D, selecione C4D de utilização geral
    • Para tipos de máquinas E2, selecione E2 de utilização geral
    • Para tipos de máquinas N1, selecione N1 de utilização geral
    • Para os tipos de máquinas N2, selecione N2 de utilização geral
    • Para os tipos de máquinas N2D, selecione N2D de utilização geral
    • Para os tipos de máquinas N4, selecione N4 de utilização geral
    • Para os tipos de máquinas Tau T2D, selecione T2D de utilização geral
    • Para tipos de máquinas G2, selecione G2 otimizado para gráficos
    • Para os tipos de máquinas M1 ou M2, selecione M1/M2 otimizado para memória
    • Para os tipos de máquinas M3, selecione M3 otimizado para memória
    • Para os tipos de máquinas M4, selecione M4 otimizado para memória
    • Para tipos de máquinas M4 com 6 TB de memória, selecione M4 com megamemória de 6 TB
    • Para tipos de máquinas X4 com 16 TB de memória, selecione X4 16 TB otimizado para memória
    • Para tipos de máquinas X4 com 24 TB de memória, selecione X4 de 24 TB otimizado para memória
    • Para tipos de máquinas X4 com 32 TB de memória, selecione X4 de 32 TB otimizado para memória
    • Para os tipos de máquinas Z3, selecione Z3 otimizado para armazenamento

  6. Na secçã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 fim personalizada para o seu compromisso, clique no botão Prolongar data de fim e, de seguida, no campo Data, especifique uma data de fim personalizada.

  7. No campo Núcleos, introduza o número de CPUs virtuais que quer comprometer-se a comprar.

  8. No campo Memória, introduza a quantidade de memória, em GB, que quer comprometer-se a comprar.

    Só pode especificar a memória em incrementos de 0,25 GB. Para especificar um valor de memória personalizado para o seu compromisso, use a CLI gcloud ou a API REST em alternativa.

  9. Para se comprometer a comprar GPUs, na secção GPUs, clique em Adicionar GPU e, de seguida, faça o seguinte:

    1. No campo Tipo de GPU, selecione o tipo de GPU.
    2. No campo Número de GPUs, introduza o número de GPUs.
    3. Opcional: se o seu modelo de GPU suportar estações de trabalho virtuais (vWS) NVIDIA RTX para cargas de trabalho de gráficos, e planeia executar cargas de trabalho com utilização intensiva de gráficos, selecione a caixa de verificação Ativar estação de trabalho virtual (NVIDIA GRID).

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

  11. Se especificou GPUs ou discos SSD locais no seu compromisso, anexe reservas correspondentes para esses recursos de uma das seguintes formas. Repita este passo para cada nova reserva que quer anexar.

    1. Para anexar uma ou mais reservas existentes ao compromisso, no campo Reservas, selecione Anexar reservas existentes e, de seguida, siga os passos indicados na secção Anexar reservas existentes.
    2. Para criar uma nova reserva e anexá-la ao compromisso, no campo Reservas, selecione Criar reservas e, de seguida, siga os passos indicados na secção Crie 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 utilização garantida, se concordar com os termos específicos do serviço, clique novamente em Comprar.

gcloud

Para comprar um compromisso com um prazo personalizado e prolongado, execute o comando gcloud compute commitments create e inclua a flag --custom-end-time.

Por exemplo, para comprar 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 o seguinte:

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

  • COMMITMENT_PLAN: o período mínimo predefinido para o qual quer comprometer-se a comprar recursos. Especifique um dos seguintes valores:

    • Para um compromisso de 1 ano: 12-month
    • Para um compromisso de 3 anos: 36-month.

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

    • Para tipos de máquinas A2, use accelerator-optimized
    • Para os tipos de máquinas A3 Edge e A3 High, use accelerator-optimized-a3
    • Para os tipos de máquinas A3 Mega, use accelerator-optimized-a3-mega
    • Para tipos de máquinas C2, use compute-optimized
    • Para tipos de máquinas C2D, use compute-optimized-c2d
    • Para os tipos de máquinas C3, use compute-optimized-c3
    • Para tipos de máquinas C3D, use compute-optimized-c3d
    • Para tipos de máquinas H3, use compute-optimized-h3
    • Para tipos de máquinas N1, use general-purpose
    • Para os tipos de máquinas C4, use general-purpose-c4
    • Para os tipos de máquinas C4A, use general-purpose-c4a
    • Para tipos de máquinas C4D, use general-purpose-c4d
    • Para tipos de máquinas E2, use general-purpose-e2
    • Para tipos de máquinas N2, use general-purpose-n2
    • Para tipos de máquinas N2D, use general-purpose-n2d
    • Para tipos de máquinas N4, use general-purpose-n4
    • Para os tipos de máquinas Tau T2D, use general-purpose-t2d
    • Para tipos de máquinas G2, use graphics-optimized
    • Para tipos de máquinas M1 ou M2, use memory-optimized
    • Para tipos de máquinas M3, use memory-optimized-m3
    • Para tipos de máquinas M4, use memory-optimized-m4
    • Para tipos de máquinas M4 com 6 TB de memória, use memory-optimized-m4-6tb
    • Para tipos de máquinas X4 com 16 TB de memória, use memory-optimized-x4-16tb
    • Para tipos de máquinas X4 com 24 TB de memória, use memory-optimized-x4-24tb
    • Para tipos de máquinas X4 com 32 TB de memória, use memory-optimized-x4-32tb
    • Para tipos de máquinas Z3, use storage-optimized-z3

    Se não especificar a flag --type, o Compute Engine usa general-purpose como valor predefinido.

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

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

  • CUSTOM_END_DATE: a data de fim personalizada do seu prazo, que tem de estar formatada como YYYY-MM-DD. Por exemplo, para especificar uma data de fim personalizada de 20 de abril de 2024, formate-a como 2024-04-20.

Para ver a sintaxe detalhada de como prolongar a duração do prazo ao comprar um compromisso para GPUs, discos SSD locais ou ambos, consulte o artigo Compre compromissos com reservas anexadas.

Por exemplo, considere um compromisso de 1 ano denominado example-commitment para 4 vCPUs N1 e 9 GB de memória na região us-central1. Suponhamos que quer comprar este compromisso a 1 de janeiro de 2024 e quer um prazo personalizado que termine a 30 de junho de 2025. Para comprar este 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 prazo personalizado e prolongado, faça um POST pedido ao método regionCommitments.insert. No corpo do pedido, inclua o campo customEndTimestamp.

Por exemplo, para comprar um compromisso para vCPUs, memória ou ambos, use o seguinte corpo do pedido 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 o seguinte:

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

  • COMMITMENT_PLAN: o período mínimo predefinido para o qual quer comprometer-se a comprar recursos. Especifique um dos seguintes valores:

    • Para um compromisso de 1 ano: TWELVE_MONTH
    • Para um compromisso de 3 anos: THIRTY_SIX_MONTH.

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

    • Para tipos de máquinas A2, use ACCELERATOR_OPTIMIZED
    • Para os tipos de máquinas A3 Edge e A3 High, use ACCELERATOR_OPTIMIZED_A3
    • Para os tipos de máquinas A3 Mega, use ACCELERATOR_OPTIMIZED_A3_MEGA
    • Para tipos de máquinas C2, use COMPUTE_OPTIMIZED
    • Para tipos de máquinas C2D, use COMPUTE_OPTIMIZED_C2D
    • Para os tipos de máquinas C3, use COMPUTE_OPTIMIZED_C3
    • Para tipos de máquinas C3D, use COMPUTE_OPTIMIZED_C3D
    • Para tipos de máquinas H3, use COMPUTE_OPTIMIZED_H3
    • Para tipos de máquinas N1, use GENERAL_PURPOSE
    • Para os tipos de máquinas C4, use GENERAL_PURPOSE_C4
    • Para os tipos de máquinas C4A, use GENERAL_PURPOSE_C4A
    • Para tipos de máquinas C4D, use GENERAL_PURPOSE_C4D
    • Para tipos de máquinas E2, use GENERAL_PURPOSE_E2
    • Para tipos de máquinas N2, use GENERAL_PURPOSE_N2
    • Para tipos de máquinas N2D, use GENERAL_PURPOSE_N2D
    • Para tipos de máquinas N4, use GENERAL_PURPOSE_N4
    • Para os tipos de máquinas Tau T2D, use GENERAL_PURPOSE_T2D
    • Para tipos de máquinas G2, use GRAPHICS_OPTIMIZED
    • Para tipos de máquinas M1 ou M2, use MEMORY_OPTIMIZED
    • Para tipos de máquinas M3, use MEMORY_OPTIMIZED_M3
    • Para tipos de máquinas M4, use MEMORY_OPTIMIZED_M4
    • Para tipos de máquinas M4 com 6 TB de memória, use MEMORY_OPTIMIZED_M4_6TB
    • Para tipos de máquinas X4 com 16 TB de memória, use MEMORY_OPTIMIZED_X4_16TB
    • Para tipos de máquinas X4 com 24 TB de memória, use MEMORY_OPTIMIZED_X4_24TB
    • Para tipos de máquinas X4 com 32 TB de memória, use MEMORY_OPTIMIZED_X4_32TB
    • Para tipos de máquinas Z3, use STORAGE_OPTIMIZED_Z3

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

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

  • CUSTOM_END_DATE: a data de fim personalizada do seu prazo, que tem de estar formatada como YYYY-MM-DD. Por exemplo, para especificar uma data de fim personalizada de 20 de abril de 2024, formate-a como 2024-04-20.

  • END_TIME: 00:00 (hora do Pacífico dos EUA e do Canadá) (UTC-8 ou UTC-7), como um desvio do Tempo Universal Coordenado (UTC). Especifique um dos seguintes valores:

    • Durante a mudança da hora: 07:00:00
    • Durante outros horários: 08:00:00

Para ver a sintaxe detalhada de como prolongar a duração do prazo ao comprar um compromisso para GPUs, discos SSD locais ou ambos, consulte o artigo Compre compromissos com reservas anexadas.

Por exemplo, considere um compromisso de 1 ano denominado example-commitment para 4 vCPUs N1 e 9 GB de memória na região us-central1. Suponhamos que quer comprar este compromisso a 1 de janeiro de 2024 e quer um prazo personalizado que termine a 30 de junho de 2025. Para comprar este compromisso, faça o seguinte pedido:

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",
}

Prolongue a duração do prazo de um compromisso existente

Pode prolongar a duração do prazo em curso do compromisso ativo existente atualizando as propriedades do compromisso para especificar ou atualizar a data de conclusão personalizada.

Para prolongar a duração de um compromisso existente, use uma das seguintes opções:

Consola

Antes de iniciar a operação de extensão do prazo, na Google Cloud consola, selecione o projeto onde quer prolongar o prazo do seu compromisso.

  1. Na Google Cloud consola, aceda à página Descontos por utilização comprometida.

    Aceda a Descontos de fidelidade

    É apresentada a página Lista de compromissos, que mostra o separador Compromissos de hardware.

  2. Para iniciar a operação de extensão do prazo de um compromisso, no separador Compromissos de hardware, selecione um compromisso ativo e, de seguida, clique em Prolongar.

    Em alternativa, pode fazer o seguinte:

    1. No separador Compromissos de hardware da página Lista de compromissos, clique no nome do compromisso ativo que quer prolongar.
    2. Na página Detalhes do compromisso de hardware para o compromisso selecionado, clique em Prolongar.

    O painel Prolongar é apresentado para o compromisso selecionado.

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

    1. Reveja os detalhes do compromisso.
    2. No campo Selecione uma data de fim, especifique uma data de fim personalizada para o seu compromisso.
    3. Na secção Linha cronológica do compromisso, reveja o campo Nova data de fim.
    4. Para confirmar o pedido de extensão do prazo, clique em Estender.

gcloud

Para prolongar a duração de um compromisso ativo existente, 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 o seguinte:

  • COMMITMENT_NAME: o nome do compromisso
  • PROJECT_ID: o ID do projeto
  • REGION: a região do compromisso e onde quer comprometer-se a comprar recursos do Compute Engine.
  • CUSTOM_END_DATE: a data de fim personalizada que quer para o seu prazo, 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 fim personalizada de 20 de abril de 2024, formate-a como 2024-04-20.

Por exemplo, considere o compromisso de prazo personalizado de 1 ano, example-commitment, que foi comprado para 4 vCPUs N1 e 9 GB de memória na região us-central1. Este compromisso foi comprado a 1 de janeiro de 2024 e expira a 30 de junho de 2025. Para prolongar ainda mais a duração do prazo 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 prolongar a duração de um compromisso ativo existente, faça um PATCH pedido ao método regionCommitments.update. No corpo do pedido, 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 o seguinte:

  • COMMITMENT_NAME: o nome do compromisso
  • REGION: a região do compromisso e onde quer comprometer-se a comprar recursos do Compute Engine.
  • PROJECT_ID: o ID do projeto
  • CUSTOM_END_DATE: a data de fim personalizada que quer para o seu prazo, 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 fim personalizada de 20 de abril de 2024, formate-a como 2024-04-20.

  • END_TIME: 00:00 (hora do Pacífico dos EUA e do Canadá) (UTC-8 ou UTC-7), como um desvio do Tempo Universal Coordenado (UTC). Especifique um dos seguintes valores:

    • Durante a mudança da hora: 07:00:00
    • Durante outros horários: 08:00:00

Por exemplo, considere o compromisso de prazo personalizado de 1 ano, example-commitment, que foi comprado para 4 vCPUs N1 e 9 GB de memória na região us-central1. Este compromisso foi comprado a 1 de janeiro de 2024 e expira a 30 de junho de 2025. Para prolongar ainda mais a duração do respetivo prazo até 30 de junho de 2026, faça o seguinte pedido:

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",
}

O que se segue?