Esta página foi traduzida pela API Cloud Translation.

Crie pedidos de reserva futuros partilhados

Este documento explica como criar pedidos de reserva futuros que são partilhados em vários projetos.

Depois de Google Cloud aprovar um pedido de reserva futura partilhada, o Compute Engine cria automaticamente (cria automaticamente) reservas com os recursos pedidos na hora de início especificada. Tem uma garantia muito elevada de que o Compute Engine fornece os seus recursos reservados, o que dá ao seu projeto e a quaisquer projetos com os quais as reservas são partilhadas acesso exclusivo a esses recursos durante todo o período de reserva. Em seguida, pode usar os recursos reservados para criar instâncias de máquinas virtuais (VMs).

Para saber mais acerca dos requisitos e das limitações que aplica quando cria um pedido de reserva futura, consulte Acerca dos pedidos de reserva futura.

Antes de começar

Se ainda não o fez, reveja as práticas recomendadas para consumir reservas criadas automaticamente partilhadas.
Tem de verificar se tem quota suficiente para os recursos que quer reservar. Se a sua quota for insuficiente, é provável que a sua futura solicitação de reserva seja recusada. Google Cloud Em alternativa, se o pedido for aprovado, mas não tiver quota na hora de início do pedido, o Compute Engine só fornece parte ou nenhum dos recursos reservados. Para mais informações acerca dos diferentes tipos de quotas no Compute Engine, consulte o artigo Quotas de atribuição.

Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
```
gcloud init
```
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.
Set a default region and zone.

REST

Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

gcloud init

Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.

Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções necessárias

Para receber as autorizações de que precisa para criar pedidos de reserva futuros partilhados, peça ao seu administrador para lhe conceder a função de IAM Utilizador de reserva futura de computação (roles/compute.futureReservationUser) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para criar pedidos de reserva futuros partilhados. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

As seguintes autorizações são necessárias para criar pedidos de reserva futuros partilhados:

Para criar um pedido de reserva futuro: compute.futureReservations.create no projeto
Para permitir que o Compute Engine crie automaticamente reservas: compute.reservations.create no projeto
Para especificar um modelo de instância: compute.instanceTemplates.useReadOnly no modelo de instância

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Restrições

Além das restrições gerais para reservas futuras, a criação de pedidos de reserva futuros partilhados tem as seguintes restrições:

O projeto que usa para criar pedidos de reserva futuros partilhados (o projeto proprietário) tem de ser adicionado à lista de autorizações para a restrição da política da organização Shared Reservations Owner Projects (compute.sharedReservationsOwnerProjects) por um administrador da política da organização. Para mais informações, consulte o artigo Permita e restrinja projetos para criar e modificar reservas partilhadas na documentação de reservas do Compute Engine.
Se mover um projeto que criou um pedido de reserva futura partilhada para uma organização diferente, a reserva futura partilhada é eliminada. O projeto não é removido automaticamente dos projetos proprietários de reservas partilhadas (compute.sharedReservationsOwnerProjects) da restrição da política organizacional, mas pode remover o projeto desta restrição, se quiser.
Cada pedido de reserva futura partilhada pode ser partilhado com até 100 projetos de consumidor.
Para cada organização, pode criar até 100 pedidos de reserva futuros partilhados para cada combinação única de propriedades de VMs.

Crie um pedido de rascunho

Quando cria um pedido de reserva futuro, pode guardar o pedido como um rascunho e enviá-lo mais tarde para Google Cloud revisão ou enviar diretamente o pedido para revisão. A Google recomenda que crie primeiro um pedido de rascunho, uma vez que isto permite determinar o número de VMs que o Compute Engine vai aprovisionar para o seu pedido, em vez de estimar manualmente este número e, opcionalmente, modificar o número de VMs reservadas no pedido antes de o enviar para revisão.

Para consumir uma reserva criada automaticamente para uma reserva futura, uma VM tem de ter propriedades que correspondam exatamente a essa reserva. Para especificar as propriedades das VMs que quer pedir para reservar criando um pedido de reserva futuro de rascunho, use um dos seguintes métodos:

Recomendado: especifique um modelo de instância

Pode usar um modelo de instância existente para definir as propriedades de um pedido de reserva futuro de rascunho. Ao usar um modelo de instância, pode definir as propriedades de um pedido de reserva futuro e as VMs que podem consumir as reservas criadas automaticamente no mesmo local. No entanto, uma vez que os modelos são específicos do projeto, não pode usar o mesmo modelo para criar VMs que possam consumir as reservas criadas automaticamente fora do projeto que criou o pedido de reserva futura. Para os projetos com os quais a reserva futura é partilhada, tem de criar modelos semelhantes nesses projetos ou criar VMs especificando as propriedades diretamente.
Especifique uma VM existente

Pode usar uma VM existente para definir as propriedades de um pedido de reserva futuro. Ao usar as propriedades de uma VM existente, pode consumir as reservas criadas automaticamente aprovisionadas para a reserva futura criando VMs com propriedades que correspondam à VM de referência.
Especifique propriedades diretamente

Pode definir diretamente as propriedades de um pedido de reserva futuro de rascunho. Este método requer que garanta manualmente que as propriedades das suas VMs e as reservas criadas automaticamente correspondem exatamente. Quaisquer propriedades que não correspondam impedem o consumo.

Uma reserva criada automaticamente para uma reserva futura pode ser consumida automaticamente por qualquer VM com propriedades correspondentes. Se quiser evitar que uma VM consuma alguma destas reservas criadas automaticamente, veja como criar VMs sem consumir reservas.

Especifique um modelo de instância

Ao criar um pedido de reserva futura partilhada especificando um modelo de instância, tenha em atenção o seguinte:

Um modelo de instância contém definições específicas do projeto, pelo que só pode aceder e usar um modelo de instância no mesmo projeto. Se criar um pedido de reserva futura partilhada especificando um modelo de instância, tem de criar modelos semelhantes para criar VMs ou criar VMs especificando propriedades correspondentes diretamente para consumir as reservas criadas automaticamente em cada projeto consumidor.
Tem de criar o seu pedido de reserva futuro na mesma região e zona que os recursos no modelo de instância. Todos os recursos regionais ou zonais especificados num modelo de instância, como um tipo de máquina ou um disco persistente, restringem a utilização do modelo às localizações onde esses recursos se encontram. Por exemplo, se o modelo de instância especificar um disco persistente existente na zona us-central1-a, tem de criar o seu pedido de reserva futuro na mesma zona. Caso contrário, a criação do pedido de reserva futura falha.

Para verificar se um modelo existente especifica recursos que associam o modelo a uma região ou uma zona específica, veja os detalhes do modelo e procure referências a recursos regionais ou zonais no respetivo interior.
Se quiser anexar as reservas criadas automaticamente aprovisionadas para uma reserva futura a um compromisso, tem de desativar a opção de eliminação automática. Para mais informações, consulte a secção Restrições após a criação.

Depois de criar um pedido de reserva futuro, não pode modificar o pedido de reserva futuro para substituir as propriedades da VM do modelo nem especificar outro modelo. Em alternativa, se precisar de alterar as propriedades da VM especificadas no pedido, tem de criar um novo pedido de reserva futura.

Para criar uma reserva futura partilhada especificando um modelo de instância existente, selecione uma das seguintes opções:

Consola

Na Google Cloud consola, aceda à página Reservas.

Aceda a Reservas
Clique no separador Reservas futuras.
Clique em Criar reserva futura.

É apresentada a página Crie uma reserva futura.
Em Nome, introduza um nome para o seu futuro pedido de reserva.
Em Prefixo, introduza um prefixo do nome. O nome de cada reserva criada automaticamente a partir deste pedido de reserva futuro começa com este prefixo.
Em Região e Zona, selecione a região e a zona nas quais quer reservar recursos.
Em Hora de início, introduza uma hora de início para o período de reserva. A hora de início não pode ser posterior a um ano a partir da data e hora em que envia um pedido de revisão de uma reserva futura. Para ter tempo suficiente para, opcionalmente, modificar, cancelar ou eliminar a reserva futura antes de entrar no respetivo tempo de bloqueio, especifique um valor recomendado para a hora de início.
Em Hora de fim, introduza uma hora de fim para o período de reserva. Na secção Resumo da duração, pode ver a duração do período de reserva. Para aumentar a probabilidade de Google Cloud aprovar o seu pedido de reserva futuro após o envio para revisão, especifique um valor recomendado para o período de reserva.
Na secção Tipo de partilha, faça o seguinte:
1. Para especificar um pedido de reserva futuro partilhado, selecione Partilhado.
2. Clique em Adicionar projetos e, de seguida, selecione os projetos da organização do projeto atual com os quais quer partilhar o pedido de reserva futuro. Pode selecionar até 100 projetos.
Para Capacidade total necessária, introduza a contagem total de VMs que quer reservar para o período, a configuração da VM e os projetos especificados neste pedido de reserva futuro.

Importante: verifique se tem quota suficiente para os recursos que está a pedir para reservar. Caso contrário, se enviar o pedido de revisão da reserva futura, Google Cloud este é recusado.
Na secção Configuração da máquina, faça o seguinte:
1. Selecione Usar modelo de instância.
2. Para Modelo de instância, selecione o modelo de instância da sua escolha. Se selecionar um modelo de instância regional, só pode reservar recursos na mesma região que a região do modelo.
Na secção Eliminação automática de reservas geradas automaticamente, faça uma das seguintes ações:
- Para permitir que o Compute Engine elimine automaticamente as reservas criadas automaticamente para o seu pedido de reserva futuro, faça o seguinte:
  
  Atenção: se a opção de eliminação automática estiver ativada, todas as reservas criadas automaticamente são eliminadas na hora de eliminação especificada, independentemente de terem sido totalmente consumidas ou não.
  1. Clique no botão Ativar eliminação automática para o ativar, se ainda não estiver ativado.
  2. Opcional: para Hora de eliminação automática, introduza uma data e uma hora para eliminar as reservas criadas automaticamente. A data e a hora têm de ser posteriores à hora de fim do período de reserva. Se deixar este campo vazio, as reservas criadas automaticamente são eliminadas no prazo de duas horas após a hora de fim do período de reserva.
- Caso contrário, clique no botão Ativar eliminação automática para o desativar.
Para terminar de criar o pedido de reserva futuro de rascunho, clique em Guardar rascunho.

É apresentada a página Reservas. A criação do pedido de reserva futuro pode demorar até 1 minuto a ser concluída.

gcloud

Para criar um pedido de reserva futuro partilhado especificando um modelo de instância, use o comando gcloud beta compute future-reservations create com as flags --share-setting=projects e --share-with.

Para criar um pedido de reserva futuro de rascunho especificando um modelo de instância sem incluir quaisquer flags opcionais e eliminar automaticamente a reserva criada automaticamente no final do período de reserva, execute o seguinte comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua o seguinte:

FUTURE_RESERVATION_NAME: o nome do pedido de reserva futuro.

CONSUMER_PROJECT_IDS: uma lista de IDs separados por vírgulas dos projetos que quer permitir que consumam as reservas criadas automaticamente para este pedido de reserva futuro. Por exemplo, project-1,project-2. Pode especificar até 100 projetos. Estes projetos têm de estar na mesma organização que o projeto onde o pedido de reserva futuro é criado (o projeto proprietário). Não especifique o projeto proprietário. Por predefinição, já é permitido consumir as reservas criadas automaticamente para este pedido de reserva futuro.

PROJECT_ID: o ID do projeto onde quer reservar recursos e onde se encontra o modelo de instância.
LOCATION: a localização do modelo de instância. Especifique um dos seguintes valores:
- Para um modelo de instância regional: regions/REGION. Substitua REGION pela região onde o modelo de instância está localizado. Se especificar um modelo de instância regional, só pode criar o pedido de reserva futuro na mesma região que a região do modelo.
- Para um modelo de instância global: global.
INSTANCE_TEMPLATE_NAME: o nome de um modelo de instância existente.

START_TIME: a hora de início do período de reserva como uma data/hora RFC 3339, que tem de ser formatada da seguinte forma:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua o seguinte:
- YYYY-MM-DD: uma data formatada como um ano de 4 dígitos, um mês de 2 dígitos e um dia do mês de 2 dígitos, separados por hífenes (-).
- HH:MM:SS: uma hora formatada como uma hora de 2 dígitos com um formato de hora de 24 horas, minutos de 2 dígitos e segundos de 2 dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um desvio do Tempo Universal Coordenado (UTC). Por exemplo, para usar a Hora Padrão do Pacífico (PST), especifique -08:00. Em alternativa, para não usar nenhum desvio, especifique Z.
A hora de início não pode ser posterior a um ano a partir da data e hora em que envia uma solicitação de revisão de uma reserva futura. Para ter tempo suficiente para cancelar, eliminar ou modificar opcionalmente um pedido de reserva futuro após a aprovação e antes de entrar no respetivo período de bloqueio, especifique um valor recomendado para a hora de início.
END_TIME: a hora de fim do período de reserva formatada como uma data/hora RFC 3339. Para aumentar a probabilidade de a Google Cloud aprovar o seu pedido após o envio, especifique um período de reserva mínimo. Para especificar uma duração em vez de uma hora de fim, substitua a flag --end-time pela flag --duration=END_DURATION. Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1 209 600 segundos (14 dias).

Para aumentar a probabilidade de a Google Google Cloud aprovar um pedido de reserva futuro depois de o enviar para revisão, especifique uma duração mínima recomendada.

Importante: para evitar erros ao criar o pedido de reserva futura, verifique se o período de reserva não se sobrepõe ao período de reserva de outro pedido de reserva futura existente com propriedades e zona de VM correspondentes e que foi criado ou é partilhado com o seu projeto atual. Para ver uma vista geral dos períodos de reserva dos seus futuros pedidos de reserva, consulte uma lista dos futuros pedidos de reserva.
TOTAL_COUNT: o total de VMs que quer reservar.
ZONE: a zona na qual reservar recursos.

Por exemplo, suponha que quer criar um pedido de reserva futuro de rascunho com o nome fr-02 na zona us-central1-a com as seguintes propriedades:

Um período de reserva que começa à meia-noite de 10 de novembro de 2024 UTC e termina à meia-noite de 10 de dezembro de 2024 UTC.
Uma contagem total de 80 VMs.

Um modelo de instância regional da região us-central1.

A opção de eliminação automática está ativada. As reservas criadas automaticamente são eliminadas no final do período de reserva.

O pedido de reserva futuro é partilhado com project-1 e project-2.

Para criar fr-02, execute o seguinte comando:

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Opcionalmente, pode fazer uma ou mais das seguintes ações:

Para eliminar as reservas criadas automaticamente após a hora de fim do período de reserva, selecione um dos seguintes métodos:

Para eliminar as reservas criadas automaticamente numa data e hora específicas após a hora de fim do período de reserva, inclua a flag --auto-created-reservations-delete-time.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e uma hora formatadas como uma data/hora RFC 3339.

Para eliminar as reservas criadas automaticamente após uma duração específica após a hora de fim do período de reserva, inclua a flag --auto-created-reservations-duration.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua DURATION_BEFORE_DELETE por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para um dia, duas horas, três minutos e quatro segundos.

Para desativar a opção de eliminação automática para as reservas criadas automaticamente, substitua a flag --auto-delete-auto-created-reservations pela flag --no-auto-delete-auto-created-reservations.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Para especificar um prefixo de nome para as reservas criadas automaticamente, inclua a flag --name-prefix.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua NAME_PREFIX pelo prefixo do nome de cada reserva criada automaticamente. Para ajudar a identificar as reservas criadas automaticamente para este pedido de reserva futuro, Google Cloud recomenda que especifique um prefixo de nome exclusivo.

REST

Para criar um pedido de reserva futuro partilhado especificando um modelo de instância, faça um pedido POST para o método beta.futureReservations.insert.

Para criar um pedido de reserva futuro de rascunho especificando um modelo de instância sem incluir campos opcionais, faça um pedido POST da seguinte forma:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua o seguinte:

PROJECT_ID: o ID do projeto no qual quer reservar recursos e onde o modelo de instância está localizado.
ZONE: a zona na qual reservar recursos.
: se definir este campo como true, o Compute Engine elimina automaticamente as reservas criadas automaticamente para esta reserva futura no prazo de duas horas a partir da hora de fim do período de reserva.AUTO_DELETE_AUTO_CREATED_RESERVATIONS Se quiser anexar as suas reservas criadas automaticamente a um compromisso, defina este campo como false.

CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: os IDs dos projetos com os quais este pedido de reserva futuro pode ser partilhado. Pode especificar até 100 projetos. Estes projetos têm de estar na mesma organização que o projeto onde o pedido de reserva futuro é criado (o projeto proprietário). Não especifique o projeto proprietário. Por predefinição, já é permitido consumir as reservas criadas automaticamente para este pedido de reserva futuro.

LOCATION: a localização do modelo de instância. Especifique um dos seguintes valores:
- Para um modelo de instância regional: regions/REGION. Substitua REGION pela região onde o modelo de instância está localizado. Se especificar um modelo de instância regional, só pode criar o pedido de reserva futuro na mesma região que a região do modelo.
- Para um modelo de instância global: global.
INSTANCE_TEMPLATE_NAME: o nome de um modelo de instância existente.

TOTAL_COUNT: o total de VMs que quer reservar.
START_TIME: a hora de início do período de reserva como uma data/hora RFC 3339, que tem de ser formatada da seguinte forma:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua o seguinte:
- YYYY-MM-DD: uma data formatada como um ano de 4 dígitos, um mês de 2 dígitos e um dia do mês de 2 dígitos, separados por hífenes (-).
- HH:MM:SS: uma hora formatada como uma hora de 2 dígitos com um formato de hora de 24 horas, minutos de 2 dígitos e segundos de 2 dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um desvio do Tempo Universal Coordenado (UTC). Por exemplo, para usar a Hora Padrão do Pacífico (PST), especifique -08:00. Em alternativa, para não usar nenhum desvio, especifique Z.
A hora de início não pode ser posterior a um ano a partir da data e hora em que envia uma solicitação de revisão de uma reserva futura. Para ter tempo suficiente para cancelar, eliminar ou modificar opcionalmente um pedido de reserva futuro após a aprovação e antes de entrar no respetivo período de bloqueio, especifique um valor recomendado para a hora de início.
END_TIME: a hora de fim do período de reserva formatada como uma data/hora RFC 3339. Para aumentar a probabilidade de a Google Cloud aprovar o seu pedido após o envio, especifique um período de reserva mínimo. Para especificar uma duração em vez de uma hora de fim, pode substituir o campo endTime pelo campo duration:
```
"duration": {
  "seconds": END_DURATION
}
```
Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1 209 600 segundos (14 dias).

Importante: para evitar erros ao criar o pedido de reserva futura, verifique se o período de reserva não se sobrepõe ao período de reserva de outro pedido de reserva futura existente com propriedades e zona de VM correspondentes e que foi criado ou é partilhado com o seu projeto atual. Para ver uma vista geral dos períodos de reserva dos seus futuros pedidos de reserva, consulte uma lista dos futuros pedidos de reserva.

Por exemplo, suponha que quer criar um pedido de reserva futuro de rascunho com o nome fr-02 na zona us-central1-a com as seguintes propriedades:

Um período de reserva que começa à meia-noite de 10 de novembro de 2024 UTC e termina à meia-noite de 10 de dezembro de 2024 UTC.
Uma contagem total de 80 VMs.

Um modelo de instância regional da região us-central1.

A opção de eliminação automática está ativada. As reservas criadas automaticamente são eliminadas no final do período de reserva.

O pedido de reserva futuro é partilhado com project-1 e project-2.

Para criar fr-02, faça um pedido POST da seguinte forma:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Opcionalmente, pode fazer uma ou mais das seguintes ações:

Para especificar um prefixo de nome para as reservas criadas automaticamente, inclua o campo namePrefix.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Para eliminar as reservas criadas automaticamente após a hora de fim do período de reserva, selecione um dos seguintes métodos:

Para eliminar as reservas criadas automaticamente após um período específico após o fim do período de reserva, defina o elemento autoDeleteAutoCreatedReservations como true e inclua o campo autoCreatedReservationsDeleteTime.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua DELETE_TIME por uma data e uma hora em que o Compute Engine elimina as reservas criadas automaticamente. A data e a hora têm de estar formatadas como uma data/hora RFC 3339.

Para eliminar as reservas criadas automaticamente após uma duração específica a partir da hora de início do período de reserva, defina o elemento autoDeleteAutoCreatedReservations como true e inclua o campo autoCreatedReservationsDuration.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604 800 segundos (7 dias).

Depois de criar um pedido de reserva futura de rascunho, pode determinar o número de VMs que o Compute Engine vai aprovisionar para o pedido.

Especifique uma VM existente

Só pode criar um pedido de reserva futuro de rascunho com base numa VM existente no mesmo projeto e zona que a VM.

Depois de o pedido de reserva futura ser aprovado por Google Cloud e entrar no respetivo período de reserva, pode consumir as reservas criadas automaticamente através da criação de VMs com propriedades que correspondam à VM de referência. Pode fazê-lo através de uma das seguintes ações:

Crie e use um modelo de instância da seguinte forma:
1. Crie um modelo de instância com base na VM de referência sem substituir as propriedades da VM de referência.
  
  Nota: não pode criar um modelo de instância com base na VM de referência fora do projeto da VM. Para os projetos com os quais a reserva é partilhada, tem de criar modelos de instâncias semelhantes nesses projetos.
2. Crie VMs com o modelo recém-criado através de um ou ambos os seguintes passos:
  - Crie uma única VM
  - Crie um grupo de instâncias geridas (MIG) zonal
Crie uma VM com propriedades que correspondam exatamente à VM de referência da seguinte forma:
- No projeto proprietário, crie uma VM com base na VM de referência sem alterar as propriedades da VM que está a criar.
- Nos projetos de consumidor, crie uma VM e certifique-se manualmente de que as respetivas propriedades e as propriedades da VM de referência correspondem.

Para criar um pedido de reserva futura partilhada que use as propriedades de uma VM existente, faça o seguinte:

Na Google Cloud consola, aceda à página Reservas.

Aceda a Reservas
Clique no separador Reservas futuras.
Clique em Criar reserva futura.

É apresentada a página Crie uma reserva futura.
Em Nome, introduza um nome para o seu futuro pedido de reserva.
Em Prefixo, introduza um prefixo do nome. O nome de cada reserva criada automaticamente a partir deste pedido de reserva futuro começa com este prefixo.
Em Região e Zona, selecione a região e a zona nas quais quer reservar recursos.
Em Hora de início, introduza uma hora de início para o período de reserva. A hora de início não pode ser posterior a um ano a partir da data e hora em que envia um pedido de revisão de uma reserva futura. Para ter tempo suficiente para, opcionalmente, modificar, cancelar ou eliminar a reserva futura antes de entrar no respetivo tempo de bloqueio, especifique um valor recomendado para a hora de início.
Em Hora de fim, introduza uma hora de fim para o período de reserva. Na secção Resumo da duração, pode ver a duração do período de reserva. Para aumentar a probabilidade de Google Cloud aprovar o seu pedido de reserva futuro após o envio para revisão, especifique um valor recomendado para o período de reserva.
Na secção Tipo de partilha, faça o seguinte:
1. Para especificar um pedido de reserva futuro partilhado, selecione Partilhado.
2. Clique em Adicionar projetos e, de seguida, selecione os projetos da organização do projeto atual com os quais quer partilhar o pedido de reserva futuro. Pode selecionar até 100 projetos.
Para Capacidade total necessária, introduza a contagem total de VMs que quer reservar para o período, a configuração da VM e os projetos especificados neste pedido de reserva futuro.

Importante: verifique se tem quota suficiente para os recursos que está a pedir para reservar. Caso contrário, se enviar o pedido de revisão da reserva futura, Google Cloud este é recusado.
Na secção Configuração da máquina, faça o seguinte:
1. Selecione Usar VM existente.
2. Para VM existente, selecione a VM cujas propriedades quer usar para criar a reserva.
Na secção Eliminação automática de reservas geradas automaticamente, faça uma das seguintes ações:
- Para permitir que o Compute Engine elimine automaticamente as reservas criadas automaticamente para o seu pedido de reserva futuro, faça o seguinte:
  
  Atenção: se a opção de eliminação automática estiver ativada, todas as reservas criadas automaticamente são eliminadas na hora de eliminação especificada, independentemente de terem sido totalmente consumidas ou não.
  1. Clique no botão Ativar eliminação automática para o ativar, se ainda não estiver ativado.
  2. Opcional: para Hora de eliminação automática, introduza uma data e uma hora para eliminar as reservas criadas automaticamente. A data e a hora têm de ser posteriores à hora de fim do período de reserva. Se deixar este campo vazio, as reservas criadas automaticamente são eliminadas no prazo de duas horas após a hora de fim do período de reserva.
- Caso contrário, clique no botão Ativar eliminação automática para o desativar.
Para terminar de criar o pedido de reserva futuro de rascunho, clique em Guardar rascunho.

É apresentada a página Reservas. A criação do pedido de reserva futuro pode demorar até 1 minuto a ser concluída.

Depois de criar um pedido de reserva futura de rascunho, pode determinar o número de VMs que o Compute Engine vai aprovisionar para o pedido.

Especifique as propriedades diretamente

Se quiser anexar as reservas criadas automaticamente aprovisionadas para uma reserva futura a um compromisso, tem de desativar a opção de eliminação automática. Para mais informações, consulte o artigo Restrições após a criação.

Para criar um pedido de reserva futuro partilhado especificando as propriedades diretamente, selecione uma das seguintes opções:

Consola

Na Google Cloud consola, aceda à página Reservas.

Aceda a Reservas
Clique no separador Reservas futuras.
Clique em Criar reserva futura.

É apresentada a página Crie uma reserva futura.
Em Nome, introduza um nome para o seu futuro pedido de reserva.
Em Prefixo, introduza um prefixo do nome. O nome de cada reserva criada automaticamente a partir deste pedido de reserva futuro começa com este prefixo.
Em Região e Zona, selecione a região e a zona nas quais quer reservar recursos.
Em Hora de início, introduza uma hora de início para o período de reserva. A hora de início não pode ser posterior a um ano a partir da data e hora em que envia um pedido de revisão de uma reserva futura. Para ter tempo suficiente para, opcionalmente, modificar, cancelar ou eliminar a reserva futura antes de entrar no respetivo tempo de bloqueio, especifique um valor recomendado para a hora de início.
Em Hora de fim, introduza uma hora de fim para o período de reserva. Na secção Resumo da duração, pode ver a duração do período de reserva. Para aumentar a probabilidade de Google Cloud aprovar o seu pedido de reserva futuro após o envio para revisão, especifique um valor recomendado para o período de reserva.
Na secção Tipo de partilha, faça o seguinte:
1. Para especificar um pedido de reserva futuro partilhado, selecione Partilhado.
2. Clique em Adicionar projetos e, de seguida, selecione os projetos da organização do projeto atual com os quais quer partilhar o pedido de reserva futuro. Pode selecionar até 100 projetos.
Para Capacidade total necessária, introduza a contagem total de VMs que quer reservar para o período, a configuração da VM e os projetos especificados neste pedido de reserva futuro.

Importante: verifique se tem quota suficiente para os recursos que está a pedir para reservar. Caso contrário, se enviar o pedido de revisão da reserva futura, Google Cloud este é recusado.
Na secção Configuração da máquina, faça o seguinte:
1. Selecione Especificar tipo de máquina se esta opção ainda não estiver selecionada.
2. Especifique o tipo de máquina a usar para as VMs reservadas.
Na secção Eliminação automática de reservas geradas automaticamente, faça uma das seguintes ações:
- Para permitir que o Compute Engine elimine automaticamente as reservas criadas automaticamente para o seu pedido de reserva futuro, faça o seguinte:
  
  Atenção: se a opção de eliminação automática estiver ativada, todas as reservas criadas automaticamente são eliminadas na hora de eliminação especificada, independentemente de terem sido totalmente consumidas ou não.
  1. Clique no botão Ativar eliminação automática para o ativar, se ainda não estiver ativado.
  2. Opcional: para Hora de eliminação automática, introduza uma data e uma hora para eliminar as reservas criadas automaticamente. A data e a hora têm de ser posteriores à hora de fim do período de reserva. Se deixar este campo vazio, as reservas criadas automaticamente são eliminadas no prazo de duas horas após a hora de fim do período de reserva.
- Caso contrário, clique no botão Ativar eliminação automática para o desativar.
Para terminar de criar o pedido de reserva futuro de rascunho, clique em Guardar rascunho.

É apresentada a página Reservas. A criação do pedido de reserva futuro pode demorar até 1 minuto a ser concluída.

gcloud

Para criar um pedido de reserva futuro partilhado especificando as propriedades diretamente, use o comando gcloud beta compute future-reservations create com as flags --share-setting=projects e --share-with.

Para criar um pedido de reserva futuro de rascunho especificando as propriedades diretamente sem incluir quaisquer flags opcionais e eliminar automaticamente a reserva criada automaticamente no final do período de reserva, execute o seguinte comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua o seguinte:

FUTURE_RESERVATION_NAME: o nome do pedido de reserva futuro.

MACHINE_TYPE: o tipo de máquina a usar para cada VM reservada.

CONSUMER_PROJECT_IDS: uma lista de IDs separados por vírgulas dos projetos que quer permitir que consumam as reservas criadas automaticamente para este pedido de reserva futuro. Por exemplo, project-1,project-2. Pode especificar até 100 projetos. Estes projetos têm de estar na mesma organização que o projeto onde o pedido de reserva futuro é criado (o projeto proprietário). Não especifique o projeto proprietário. Por predefinição, já é permitido consumir as reservas criadas automaticamente para este pedido de reserva futuro.

START_TIME: a hora de início do período de reserva como uma data/hora RFC 3339, que tem de ser formatada da seguinte forma:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua o seguinte:
- YYYY-MM-DD: uma data formatada como um ano de 4 dígitos, um mês de 2 dígitos e um dia do mês de 2 dígitos, separados por hífenes (-).
- HH:MM:SS: uma hora formatada como uma hora de 2 dígitos com um formato de hora de 24 horas, minutos de 2 dígitos e segundos de 2 dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um desvio do Tempo Universal Coordenado (UTC). Por exemplo, para usar a Hora Padrão do Pacífico (PST), especifique -08:00. Em alternativa, para não usar nenhum desvio, especifique Z.
A hora de início não pode ser posterior a um ano a partir da data e hora em que envia uma solicitação de revisão de uma reserva futura. Para ter tempo suficiente para cancelar, eliminar ou modificar opcionalmente um pedido de reserva futuro após a aprovação e antes de entrar no respetivo período de bloqueio, especifique um valor recomendado para a hora de início.
END_TIME: a hora de fim do período de reserva formatada como uma data/hora RFC 3339. Para aumentar a probabilidade de a Google Cloud aprovar o seu pedido após o envio, especifique um período de reserva mínimo. Para especificar uma duração em vez de uma hora de fim, substitua a flag --end-time pela flag --duration=END_DURATION. Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1 209 600 segundos (14 dias).

Para aumentar a probabilidade de a Google Google Cloud aprovar um pedido de reserva futuro depois de o enviar para revisão, especifique uma duração mínima recomendada.

Importante: para evitar erros ao criar o pedido de reserva futura, verifique se o período de reserva não se sobrepõe ao período de reserva de outro pedido de reserva futura existente com propriedades e zona de VM correspondentes e que foi criado ou é partilhado com o seu projeto atual. Para ver uma vista geral dos períodos de reserva dos seus futuros pedidos de reserva, consulte uma lista dos futuros pedidos de reserva.
TOTAL_COUNT: o total de VMs que quer reservar.
ZONE: a zona na qual reservar recursos.

Por exemplo, suponha que quer criar um pedido de reserva futuro de rascunho com o nome fr-02 na zona us-central1-a com as seguintes propriedades:

Um período de reserva que começa à meia-noite de 10 de novembro de 2024 UTC e termina à meia-noite de 10 de dezembro de 2024 UTC.
Uma contagem total de 80 VMs.

Um tipo de máquina predefinido N2 com 4 vCPUs.

A opção de eliminação automática está ativada. As reservas criadas automaticamente são eliminadas no final do período de reserva.

O pedido de reserva futuro é partilhado com project-1 e project-2.

Para criar fr-02, execute o seguinte comando:

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Opcionalmente, pode fazer uma ou mais das seguintes ações:

Para anexar GPUs às suas VMs N1 reservadas, inclua a flag --accelerator.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua o seguinte:

NUMBER_OF_ACCELERATORS: o número de GPUs a adicionar por VM reservada.
ACCELERATOR_TYPE: a modelo de GPU suportado para VMs N1. Para evitar erros, verifique se o modelo de GPU escolhido está disponível na zona onde está a criar o pedido de reserva futura.

Para eliminar as reservas criadas automaticamente após a hora de fim do período de reserva, selecione um dos seguintes métodos:

Para eliminar as reservas criadas automaticamente numa data e hora específicas após a hora de fim do período de reserva, inclua a flag --auto-created-reservations-delete-time.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e uma hora formatadas como uma data/hora RFC 3339.

Para eliminar as reservas criadas automaticamente após uma duração específica após a hora de fim do período de reserva, inclua a flag --auto-created-reservations-duration.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Para anexar discos SSD local a um tipo de máquina que não inclui discos SSD local por predefinição, inclua a flag --local-ssd. Só pode anexar um disco SSD local de 375 GB.
```
gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=count=NUMBER_OF_LOCAL_SSD_DISKS,size=375,interface=INTERFACE_TYPE \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE
```
Substitua o seguinte:
- NUMBER_OF_LOCAL_SSD_DISKS: o número de discos SSD locais a anexar.
- INTERFACE_TYPE: o tipo de interface de disco que quer que os discos SSD local usem e que o tipo de máquina especificado suporta. Especifique um dos seguintes valores:
  - Para a interface de disco NVME: nvme
  - Para a interface de disco SCSI: scsi

Para que as VMs reservadas usem uma plataforma de CPU mínima específica em vez da plataforma de CPU predefinida da zona, inclua o sinalizador --min-cpu-platform.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua MIN_CPU_PLATFORM por uma plataforma de CPU mínima. Para se certificar de que uma plataforma de CPU está disponível na zona onde está a reservar recursos, veja as plataformas de CPU disponíveis por zona.

Para especificar um prefixo de nome para as reservas criadas automaticamente, inclua a flag --name-prefix.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

REST

Para criar um pedido de reserva futuro partilhado especificando as propriedades diretamente, faça um pedido POST ao método beta.futureReservations.insert.

Para criar um pedido de reserva futuro de rascunho especificando as propriedades diretamente sem incluir campos opcionais, faça um pedido POST da seguinte forma:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua o seguinte:

PROJECT_ID: o ID do projeto no qual quer reservar recursos.
ZONE: a zona na qual reservar recursos.
: se definir este campo como true, o Compute Engine elimina automaticamente as reservas criadas automaticamente para esta reserva futura no prazo de duas horas a partir da hora de fim do período de reserva.AUTO_DELETE_AUTO_CREATED_RESERVATIONS Se quiser anexar as suas reservas criadas automaticamente a um compromisso, defina este campo como false.

CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: os IDs dos projetos com os quais este pedido de reserva futuro pode ser partilhado. Pode especificar até 100 projetos. Estes projetos têm de estar na mesma organização que o projeto onde o pedido de reserva futuro é criado (o projeto proprietário). Não especifique o projeto proprietário. Por predefinição, já é permitido consumir as reservas criadas automaticamente para este pedido de reserva futuro.

TOTAL_COUNT: o total de VMs que quer reservar.
START_TIME: a hora de início do período de reserva como uma data/hora RFC 3339, que tem de ser formatada da seguinte forma:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua o seguinte:
- YYYY-MM-DD: uma data formatada como um ano de 4 dígitos, um mês de 2 dígitos e um dia do mês de 2 dígitos, separados por hífenes (-).
- HH:MM:SS: uma hora formatada como uma hora de 2 dígitos com um formato de hora de 24 horas, minutos de 2 dígitos e segundos de 2 dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um desvio do Tempo Universal Coordenado (UTC). Por exemplo, para usar a Hora Padrão do Pacífico (PST), especifique -08:00. Em alternativa, para não usar nenhum desvio, especifique Z.
A hora de início não pode ser posterior a um ano a partir da data e hora em que envia uma solicitação de revisão de uma reserva futura. Para ter tempo suficiente para cancelar, eliminar ou modificar opcionalmente um pedido de reserva futuro após a aprovação e antes de entrar no respetivo período de bloqueio, especifique um valor recomendado para a hora de início.
END_TIME: a hora de fim do período de reserva formatada como uma data/hora RFC 3339. Para aumentar a probabilidade de a Google Cloud aprovar o seu pedido após o envio, especifique um período de reserva mínimo. Para especificar uma duração em vez de uma hora de fim, pode substituir o campo endTime pelo campo duration:
```
"duration": {
  "seconds": END_DURATION
}
```
Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1 209 600 segundos (14 dias).

Importante: para evitar erros ao criar o pedido de reserva futura, verifique se o período de reserva não se sobrepõe ao período de reserva de outro pedido de reserva futura existente com propriedades e zona de VM correspondentes e que foi criado ou é partilhado com o seu projeto atual. Para ver uma vista geral dos períodos de reserva dos seus futuros pedidos de reserva, consulte uma lista dos futuros pedidos de reserva.

Por exemplo, suponha que quer criar um pedido de reserva futuro de rascunho com o nome fr-02 na zona us-central1-a com as seguintes propriedades:

Um período de reserva que começa à meia-noite de 10 de novembro de 2024 UTC e termina à meia-noite de 10 de dezembro de 2024 UTC.
Uma contagem total de 80 VMs.

Um tipo de máquina predefinido N2 com 4 vCPUs.

A opção de eliminação automática está ativada. As reservas criadas automaticamente são eliminadas no final do período de reserva.

O pedido de reserva futuro é partilhado com project-1 e project-2.

Para criar fr-02, faça um pedido POST da seguinte forma:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Opcionalmente, pode fazer uma ou mais das seguintes ações:

Para especificar um prefixo de nome para as reservas criadas automaticamente, inclua o campo namePrefix.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Para anexar GPUs às suas VMs N1 reservadas, inclua o campo guestAccelerators.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua o seguinte:

NUMBER_OF_ACCELERATORS: o número de GPUs a adicionar por VM reservada.
ACCELERATOR_TYPE: a modelo de GPU suportado para VMs N1. Para evitar erros, verifique se o modelo de GPU escolhido está disponível na zona onde está a criar o pedido de reserva futura.

Para associar discos SSD locais a um tipo de máquina que não inclui discos SSD locais por predefinição, inclua o campo localSsds no corpo do pedido. Só pode anexar discos SSD locais de 375 GB.

Por exemplo, para especificar dois discos SSD locais quando cria um pedido de reserva futuro de rascunho, faça um pedido POST da seguinte forma:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_TYPE"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua INTERFACE_TYPE pelo tipo de interface de disco que quer que os discos SSD locais usem e que o tipo de máquina especificado suporta. Especifique um dos seguintes valores:

Para a interface de disco NVME: NVME
Para a interface de disco SCSI: SCSI

Para que as VMs reservadas usem uma plataforma de CPU mínima específica em vez da plataforma de CPU predefinida da zona, inclua o parâmetro minCpuPlatform.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua MIN_CPU_PLATFORM por uma plataforma de CPU mínima. Para verificar se uma plataforma de CPU está disponível na zona onde está a reservar recursos, veja as plataformas de CPU disponíveis por zona.

Para eliminar as reservas criadas automaticamente após a hora de fim do período de reserva, selecione um dos seguintes métodos:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua DELETE_TIME por uma data e uma hora em que o Compute Engine elimina as reservas criadas automaticamente. A data e a hora têm de estar formatadas como uma data/hora RFC 3339.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604 800 segundos (7 dias).

Depois de criar um pedido de reserva futura de rascunho, pode determinar o número de VMs que o Compute Engine vai aprovisionar para o pedido.

Envie um pedido de rascunho

Depois de um pedido de reserva futura ser enviado, aprovado por Google Cloude ultrapassar o tempo de bloqueio, só pode eliminar a reserva futura e as respetivas reservas criadas automaticamente após o fim do período de reserva da reserva futura. A eliminação de uma reserva futura existente é útil se precisar de criar outra reserva futura com as mesmas propriedades. Assim, antes de criar um pedido de reserva futuro, certifique-se do seguinte:

As reservas existentes ou futuras num projeto restringem as definições de partilha dos futuros pedidos de reserva que pode criar. Para garantir que pode criar com êxito um pedido de reserva futuro e que o seu pedido não causa problemas noutros projetos com os quais partilha pedidos de reserva futuros ou reservas, consulte as restrições.
Tem de comprometer-se a pagar os recursos reservados que o Compute Engine aprovisiona durante todo o período de reserva, independentemente de as reservas criadas automaticamente serem consumidas ou não. Para mais informações, consulte Faturação.

Se quiser modificar uma ou mais propriedades quando enviar o pedido de reserva futuro em rascunho para revisão, consulte o artigo Modificar pedidos de reserva futuros.

Para enviar um pedido de reserva futura em rascunho para Google Cloud para revisão, selecione uma das seguintes opções:

Consola

Na Google Cloud consola, aceda à página Reservas.

Aceda a Reservas
Clique no separador Reservas futuras.
Na coluna Nome, clique no nome do pedido de reserva futuro com um estado de aprovisionamento de Rascunho.

É apresentada a página Reservas futuras com os detalhes do pedido de reserva futura.
Clique em Editar rascunho.

É aberta a página para atualizar o pedido de reserva futuro de rascunho.
Para enviar o pedido de reserva futura de rascunho para revisão, clique em Enviar.

É apresentada a página Reserva. Na coluna Estado do pedido de reserva futuro que acabou de enviar, o estado de aprovisionamento está definido como Aprovação pendente.

gcloud

Para enviar um pedido de reserva futuro de rascunho para revisão, use o comando gcloud beta compute future-reservations update com a flag --planning-status definida como SUBMITTED.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

Substitua o seguinte:

FUTURE_RESERVATION_NAME: o nome de um pedido de reserva futuro de rascunho existente.
ZONE: a zona onde se encontra o futuro pedido de reserva.

REST

Para enviar um pedido de reserva futuro de rascunho para revisão, faça um PATCH pedido ao método beta.futureReservations.update. No corpo do pedido, inclua o campo planningStatus e defina-o como SUBMITTED.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

Substitua o seguinte:

PROJECT_ID: o ID do projeto onde se encontra o futuro pedido de reserva.
ZONE: a zona onde se encontra o futuro pedido de reserva.
FUTURE_RESERVATION_NAME: o nome de um pedido de reserva futuro de rascunho existente.

Depois de enviar um pedido de reserva futura de rascunho para revisão, pode fazer o seguinte:

Para monitorizar o estado de aprovisionamento do pedido e ver se Google Cloud aprovou ou recusou o seu pedido, veja os detalhes do seu pedido de reserva futuro.
Para impedir Google Cloud que a Google reveja o seu pedido e evitar que o Compute Engine aprovisione a capacidade pedida, cancele ou elimine o seu pedido de reserva futura.

Resolver problemas

Se tiver problemas ao criar um pedido de reserva futuro, saiba como resolver problemas de pedidos de reserva futuros.

Se continuar a ter problemas após a resolução, contacte a sua equipa da conta ou a equipa de vendas.

O que se segue?

Saiba como ver pedidos de reserva futuros.
Saiba como modificar pedidos de reserva futuros.
Saiba como cancelar ou eliminar pedidos de reserva futuros.
Depois de atingir a hora de início do período de reserva, saiba como usar as reservas criadas automaticamente.

Crie pedidos de reserva futuros partilhados Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Console

gcloud

REST

Funções necessárias

Autorizações necessárias

Restrições

Crie um pedido de rascunho

Especifique um modelo de instância

Consola

gcloud

REST

Especifique uma VM existente

Especifique as propriedades diretamente

Consola

gcloud

REST

Envie um pedido de rascunho

Consola

gcloud

REST

Resolver problemas

O que se segue?

Crie pedidos de reserva futuros partilhados