Modificar, cancelar ou excluir solicitações de reservas adiantadas

Neste documento, explicamos como gerenciar solicitações de reservas adiantadas. Especificamente:

Modifique um rascunho ou uma solicitação de reserva adiantada enviada para alterar uma ou mais propriedades dele.
Cancele uma solicitação de reserva adiantada para impedir que o Google Cloud a analise ou impeça que uma reserva adiantada aprovada entre no horário de bloqueio.
Exclua uma reserva adiantada antes que ela entre no tempo de bloqueio necessário ou após o final do período de reserva.

Se você quiser gerenciar as reservas criadas automaticamente para uma reserva adiantada atendida após o término do período de reserva, consulte estes recursos:

Antes de começar

Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

Selecione a guia para como planeja usar as amostras nesta página:
Console

Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
```
gcloud init
```
  Observação: se você instalou a CLI gcloud anteriormente, verifique se tem a versão mais recente executando gcloud components update.
2. Defina uma região e uma zona padrão.
REST

Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

Funções exigidas

Para receber as permissões necessárias para modificar, cancelar ou excluir suas solicitações de reserva adianta, peça ao seu administrador para conceder a você o papel Administrador do Compute (roles/compute.futureReservationAdmin) Papel do IAM no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esse papel predefinido contém as permissões necessárias para modificar, cancelar ou excluir seus pedido de reservas adiantadas. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para modificar, cancelar ou excluir:

Para cancelar uma reserva adiantada: compute.futureReservations.cancel no projeto
Para excluir uma reserva adiantada: compute.futureReservations.delete no projeto
Para modificar uma reserva adiantada: compute.futureReservations.update no projeto

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Restrições

Além das restrições gerais para reservas adiantadas, quando você modifica, cancela ou exclui uma solicitação de reserva adiantada, as seguintes restrições são aplicadas:

Só é possível modificar, cancelar ou excluir uma solicitação de reserva adiantada no projeto em que ela foi criada. Isso permite compartilhar uma solicitação de reserva futura com outros projetos, mas os usuários com permissões apenas para outros projetos não podem modificar essa solicitação de reserva futura.

Só será possível modificar, cancelar ou excluir uma solicitação de reserva adiantada se o status de aquisição permitir. Veja mais detalhes na tabela a seguir:

Status da compra	Cancelar	Excluir	Modificar
Rascunho (`DRAFTING`)
Aprovação pendente (`PENDING_APPROVAL`)
Aprovado (`APPROVED`)
Recusado (`DECLINED`)
Cancelado (`CANCELED`)
Em aquisição (`PROCURING`)
Provisionando (`PROVISIONING`)
Concluído (`FULFILLED`)		^*
Parcialmente atendida (`FAILED_PARTIALLY_FULFILLED`)		^*
Falha (`FAILED`)		^*

^*Só é possível excluir uma reserva futura atendida, parcialmente atendida ou com falha depois do horário de término.

Modificar solicitações de reserva adiantadas

É possível modificar uma solicitação de reserva adiantada antes que ela alcance um status de aquisição de Provisionamento (PROVISIONING), desde que ela não seja cancelada ou tenha aprovação pendente. Ao modificar uma solicitação de reserva adiantada, não é possível alterar as seguintes propriedades:

Para qualquer reserva adiantada:
- O nome da reserva adiantada.
- O projeto em que a solicitação de reserva adiantada foi criada.
- A zona em que está localizada a VM.
Para solicitações de reserva adiantadas criadas com a especificação de um modelo de instância:
- Não é possível substituir as propriedades da VM especificadas no modelo de instância.
- Não é possível substituir o modelo de instância usado para criar uma solicitação de reserva adiantada por outro modelo.

Para modificar qualquer uma dessas propriedades, é preciso criar uma nova solicitação de reserva adiantada com as atualizações que você quer.

Para modificar outras propriedades, selecione um dos seguintes métodos:

Modificar um rascunho ou uma solicitação de reserva adiantada recusada.

Nesta seção, explicamos como modificar uma solicitação de reserva adiantada com um status de compra definido como Rascunho (DRAFTING) ou recusado (DECLINED).
Modificar uma reserva adiantada aprovada ou adquirida.

Nesta seção, explicamos como modificar uma reserva adiantada com um status de aquisição definido como Aprovado (APPROVED) ou Em aquisição (PROCURING). Para modificar a opção de exclusão automática, a descrição ou o prefixo do nome de uma reserva adiantada, modifique sem revisão. Caso contrário, se você quiser modificar outras propriedades, precisará da aprovação do Google Cloud.

Modificar um rascunho ou recusar a solicitação de reserva adiantada

Se você modificar um rascunho de solicitação de reserva adiantada, poderá salvar as alterações ou enviar a solicitação de reserva adiantada atualizada ao Google Cloud para revisão. Em vez disso, se você modificar uma solicitação de reserva adiantada recusada, precisará enviá-la para revisão.

Para modificar as propriedades de um rascunho ou de uma solicitação de reserva adiantada recusada, selecione um dos seguintes métodos:

Modificar um rascunho ou uma solicitação de reserva adiantada criada especificando um modelo de instância.

Nesta seção, explicamos como modificar uma ou mais propriedades em um rascunho ou uma solicitação de reserva adiantada recusada criada com a especificação de um modelo de instância. Não é possível modificar as propriedades da VM de uma solicitação de reserva adiantada. Em vez disso, é necessário criar uma nova reserva adiantada.
Modificar um rascunho ou uma solicitação de reserva adiantada recusada criada especificando diretamente as propriedades.

Nesta seção, explicamos como modificar uma ou mais propriedades em um rascunho ou uma solicitação de reserva adiantada recusada que foi criada com a especificação direta de propriedades.

Modificar um rascunho ou uma reserva adiantada recusada especificando um modelo de instância.

Para uma solicitação de reserva adiantada criada especificando um modelo de instância com um status de aquisição de rascunho (DRAFTING) ou recusado (DECLINED), você pode modificar as seguintes propriedades:

Exclusão automática
Descrição
Prefixo de nome
Configurações de compartilhamento
Horário de início e término do período de reserva
Contagem total (número de VMs)

É possível modificar um rascunho ou uma solicitação de reserva futura recusada que foi criada especificando um modelo de instância usando o console do Google Cloud, a CLI gcloud e o REST.

Console

Para solicitar que o Google Cloud modifique um rascunho ou uma solicitação de reserva adiantada recusada criada ao especificar um modelo de instância, siga estas etapas:

No console do Google Cloud, acesse a página Reservas.

Acessar "Reservas"
Clique na guia Reservas adiantadas.
Na coluna Nome, clique no nome da solicitação de reserva adiantada que você quer modificar.

A página de detalhes da solicitação de reserva adiantada selecionada é aberta.
Para modificar a solicitação de reserva adiantada, clique em Editar ou Editar rascunho.

A página para editar a solicitação de reserva adiantada selecionada será aberta.
Ter um ou mais dos seguintes:
- No campo Prefixo, digite um novo prefixo de nome.
- No campo Descrição, digite uma nova descrição.
- Modifique o Horário de início ou o Horário de término do seu pedido de reserva adiantada. Certifique-se disto:
  - O horário de início não pode ser posterior a um ano da data e hora em que você enviou uma solicitação de reserva adiantada para análise.
  - Especifique um valor recomendado para o horário de início a fim de garantir que você tenha tempo suficiente antes que sua reserva adiantada entre no horário de bloqueio.
  - Especifique um período mínimo de reserva recomendado para aumentar a probabilidade do Google Cloud aprovar sua solicitação depois de enviá-la para revisão.
- Na seção Tipo de compartilhamento, é possível selecionar Local ou Compartilhado. Se você selecionar Compartilhado, será possível adicionar ou remover projetos para compartilhar a solicitação de reserva adiantada.
  
  É possível selecionar até 100 projetos. Esses projetos precisam estar na mesma organização do projeto em que a solicitação de reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente para essa solicitação adiantada.
- Na funçãoNúmero de instâncias de VM insira o número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.
  
  Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica as reservas atuais. Se houver reservas atuais que correspondam à reserva adiantada aprovada, o número de reservas atuais será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine cria. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.
  
  Cuidado: verifique se há cota suficiente para os recursos que você quer reservar. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.
- Na seção Exclusão automática de reservas geradas automaticamente, é possível ativar ou desativar a exclusão automática de reservas criadas automaticamente para seu pedido de reserva adiantada.
  
  Atenção: se a opção de exclusão automática estiver ativada, todas as reservas criadas automaticamente serão excluídas no horário de exclusão especificado, independentemente de serem totalmente consumidas ou não.
  
  Opcional. Se você ativar a opção de exclusão automática, será possível especificar a data e a hora em que o Compute Engine excluirá as reservas criadas automaticamente. A data e a hora precisam ser posteriores ao horário de término do período de reserva. Se você deixar este campo em branco, as reservas criadas automaticamente serão excluídas em até duas horas após o horário de término do período de reserva.
Dependendo do status de aquisição da solicitação de reserva adiantada que você está modificando, siga um destes procedimentos:
- Para o rascunho de uma solicitação de reserva adiantada, selecione uma das seguintes opções:
  - Para salvar as mudanças, clique em Salvar rascunho.
  - Para enviar o rascunho da solicitação de reserva adiantada ao Google Cloud para análise, clique em Enviar.
- Para uma solicitação de reserva adiantada recusada, basta enviá-la para revisão clicando em Enviar.
  
  Se você enviar uma solicitação, a página Reservas vai abrir. Caso contrário, a página de detalhes da solicitação de reserva adiantada será aberta.

gcloud

Para solicitar que o Google Cloud modifique um rascunho ou uma solicitação de reserva adiantada recusada criada ao especificar um modelo de instância, use a função gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome de um rascunho atual ou de uma solicitação de reserva adiantada recusada.

DESCRIPTION: opcional. Uma nova descrição para o pedido de reserva adiantada.

NAME_PREFIX: opcional. Um novo prefixo de nome para a solicitação de reserva adiantada. O nome de cada reserva criada automaticamente para essa solicitação de reserva adiantada começa com o prefixo de nome. Para ajudar a identificar as reservas criadas automaticamente para essa solicitação de reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da solicitação de reserva adiantada. Só é possível especificar SUBMITTED, que envia a solicitação de reserva adiantada ao Google Cloud para revisão.

Observação: se você estiver modificando um rascunho de solicitação de reserva adiantada e quiser salvar as alterações em vez de enviar sua solicitação ao Google Cloud para revisão, omita a Flag --planning-status.

PROJECT_ID: opcional. O ID do projeto em que a solicitação de reserva adiantada foi criada. Se você modificar uma solicitação de reserva adiantada de projeto único em uma solicitação de reserva adiantada compartilhada, esse projeto se tornará o proprietário do pedido de reserva adiantada. Se você omitir a sinalização --project, o valor será definido como o ID do projeto atual.

SHARE_SETTING: opcional. Para alterar o tipo dessa solicitação de reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma solicitação de reserva adiantada de projeto único em uma solicitação de reserva adiantada compartilhada, especifique projects. Especifique pelo menos um projeto de consumidor usando a sinalização --share-with. Caso contrário, a modificação da reserva adiantada falhará.
- Caso contrário, especifique local.
  
  Importante: se você especificar local, omita a sinalização --share-with. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
CONSUMER_PROJECT_IDS: opcional. Uma lista separada por vírgulas dos IDs de projeto com que essa solicitação de reserva adiantada pode ser compartilhada. Por exemplo, especifique project-1,project-2. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que essa solicitação de reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente para essa solicitação adiantada.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua:
- YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
- HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
O horário de início não pode ser posterior a 1 ano a partir da data e do horário em que você envia uma solicitação de reserva adiantada para análise. Para ter tempo suficiente para cancelar, excluir ou modificar uma reserva adiantada após a aprovação ou antes de entrar no horário de bloqueio, especifique um horário de início recomendado.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Outra possibilidade é substituir a flag --end-time pela flag --duration=END_DURATION, em que END_DURATION é a duração do período de reserva em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Atenção: verifique se você tem cota suficiente para os recursos que está solicitando reserva. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.

Cuidado: verifique se há cota suficiente para os recursos que você quer reservar. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.

ZONE: a zona em que a solicitação de reserva adiantada está localizada.

Também é possível alterar se e quando o Compute Engine excluir automaticamente as reservas criadas automaticamente para uma solicitação de reserva adiantada fazendo um dos seguintes procedimentos:

Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente após o horário de término do período de reserva, selecione um dos seguintes métodos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas dentro de duas horas após o horário de término (padrão), especifique a sinalização --auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, especifique as flags --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339.
- Para excluir as reservas criadas automaticamente após uma duração específica e após o horário de término do período de reserva, especifique as sinalizações --auto-delete-auto-created-reservations e --auto-created-reservations-duration.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  Substitua DURATION_BEFORE_DELETE por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.
Para impedir que o Compute Engine exclua automaticamente as reservas criadas automaticamente, especifique a flag --no-auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

Por exemplo, pense em uma solicitação de reserva adiantada compartilhada como fr-03 e localizada na zona us-central1-a. Suponha que você queira modificar essa solicitação de reserva adiantada compartilhada fazendo as seguintes alterações:

Converta-o em uma solicitação de reserva adiantada de projeto único.
Desativar a opção de exclusão automática.
Reservar 100 VMs.
Envie a solicitação de reserva adiantada ao Google Cloud para aprovação.

Para modificar fr-03, execute o seguinte comando:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Para solicitar que o Google Cloud modifique um rascunho ou uma solicitação de reserva adiantada recusada criada ao especificar um modelo de instância, faça uma PATCH. para o método beta.futureReservations.update. No parâmetro de consulta updateMask, especifique cada campo que você quer atualizar. Se você precisar excluir um campo opcional da reserva, inclua esse campo no parâmetro de consulta updateMask e omita esse campo do corpo da solicitação.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Substitua:

PROJECT_ID: o ID do projeto em que a solicitação de reserva adiantada está localizada.
ZONE: a zona em que a solicitação de reserva adiantada está localizada.
FUTURE_RESERVATION_NAME: o nome de um rascunho atual ou de uma solicitação de reserva adiantada recusada. Não é possível modificar o nome de uma solicitação de reserva futura.
UPDATE_FIELDS: uma lista de campos separados por vírgulas a serem atualizados nessa solicitação PATCH. Codifique cada vírgula como %2C. Por exemplo, se você quiser atualizar os campos autoDeleteAutoCreatedReservations, totalCount e endTime em sua solicitação de reserva futura, especifique o seguinte:
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: opcional. Se você definir esse campo como true, o Compute Engine excluirá automaticamente as reservas criadas automaticamente para essa solicitação de reserva adiantada. Por padrão, o horário de exclusão é em até duas horas após o horário de término do período de reserva. Para mudar isso, siga um destes procedimentos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDeleteTime.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  Substitua DELETE_TIME por uma data e hora em que o Compute Engine exclui as reservas. A data e a hora precisam ser formatadas como carimbo de data/hora RFC 3339, que precisa ser conforme a seguir:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Substitua:
  - YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
  - HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
  - OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
- Para excluir as reservas criadas automaticamente após uma duração específica a partir do horário de início do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDuration.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604.800 segundos (7 dias).
DESCRIPTION: opcional. Para atualizar a descrição dessa solicitação de reserva futura, siga um destes procedimentos:
- Especifique uma descrição para adicionar ou atualizar.
- Para remover a descrição, exclua o campo description do corpo da solicitação e especifique-o em UPDATE_FIELDS.
NAME_PREFIX: opcional. Um novo prefixo de nome para a solicitação de reserva adiantada. O nome de cada reserva criada automaticamente para essa solicitação de reserva adiantada começa com o prefixo de nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da solicitação de reserva adiantada. Só é possível especificar SUBMITTED, que envia a solicitação de reserva adiantada ao Google Cloud para revisão.

Observação: se você estiver modificando um rascunho de solicitação de reserva adiantada e quiser salvar as alterações em vez de enviar sua solicitação ao Google Cloud para revisão, omita o campo planningStatus.
SHARE_TYPE: opcional. Para alterar o tipo de compartilhamento dessa solicitação de reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma solicitação de reserva adiantada de projeto único em uma solicitação de reserva adiantada compartilhada, especifique SPECIFIC_PROJECTS. Além disso, é preciso especificar pelo menos um projeto de consumidor no campo projects. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
- Caso contrário, especifique LOCAL. Além disso, exclua o campo projects do corpo da solicitação e especifique-o em UPDATE_FIELDS. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: opcional. Os IDs de projetos com que uma solicitação de reserva adiantada pode ser compartilhada. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que a solicitação de reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente para essa solicitação adiantada.

TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Cuidado: verifique se há cota suficiente para os recursos que você quer reservar. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339. O horário de início não pode ser posterior a 1 ano da data e do horário em que você enviar um pedido de reserva adiantada para análise. Além disso, especifique um horário de início recomendado para garantir que você tenha tempo suficiente antes que uma reserva adiantada entre no horário de bloqueio.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Como alternativa, é possível substituir o campo endTime pelo campo duration para especificar uma duração específica a partir do horário de início do período de reserva:
```
"duration": {
  "seconds": "END_DURATION"
}
```
Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.

Converta-o em uma solicitação de reserva adiantada de projeto único.
Desativar a opção de exclusão automática.
Reservar 100 VMs.
Envie a solicitação de reserva adiantada ao Google Cloud para aprovação.

Para modificar fr-03, faça a seguinte solicitação PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Depois de enviar uma solicitação de reserva adiantada ao Google Cloud para análise, confira os detalhes para monitorar o status da aquisição.

Modificar um rascunho ou uma reserva adiantada recusada especificando diretamente as propriedades.

Para uma solicitação de reserva adiantada criada diretamente pelas propriedades com um status de aquisição definido como Rascunho (DRAFTING) ou Recusado (DECLINED), é possível modificar as seguintes propriedades:

Exclusão automática
Descrição
Prefixo de nome
GPUs
SSDs locais e o tipo de interface do disco
Série e tipo de máquina
Plataforma mínima de CPU
Configurações de compartilhamento
Horário de início e término do período de reserva
Contagem total (número de VMs)

É possível modificar um rascunho ou uma solicitação de reserva futura recusada que foi criada especificando propriedades diretamente usando o console do Google Cloud, a gcloud CLI e o REST.

Console

Para solicitar que o Google Cloud modifique um rascunho ou uma solicitação de reserva adiantada recusada criada ao especificar propriedades diretamente, siga estas etapas:

No console do Google Cloud, acesse a página Reservas.

Acessar "Reservas"
Clique na guia Reservas adiantadas.
Na coluna Nome, clique no nome da solicitação de reserva adiantada que você quer modificar.

A página de detalhes da solicitação de reserva adiantada selecionada é aberta.
Para modificar a solicitação de reserva adiantada, clique em Editar ou Editar rascunho.

A página para editar a solicitação de reserva adiantada selecionada será aberta.
Ter um ou mais dos seguintes:
- No campo Prefixo, digite um novo prefixo de nome.
- No campo Descrição, digite uma nova descrição.
- Modifique o Horário de início ou o Horário de término do seu pedido de reserva adiantada. Certifique-se disto:
  - O horário de início não pode ser posterior a um ano da data e hora em que você enviou uma solicitação de reserva adiantada para análise.
  - Especifique um valor recomendado para o horário de início a fim de garantir que você tenha tempo suficiente antes que sua reserva adiantada entre no horário de bloqueio.
  - Especifique um período mínimo de reserva recomendado para aumentar a probabilidade do Google Cloud aprovar sua solicitação depois de enviá-la para revisão.
- Na seção Tipo de compartilhamento, é possível selecionar Local ou Compartilhado. Se você selecionar Compartilhado, será possível adicionar ou remover projetos para compartilhar a solicitação de reserva adiantada.
  
  É possível selecionar até 100 projetos. Esses projetos precisam estar na mesma organização do projeto em que a solicitação de reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente para essa solicitação adiantada.
- Na funçãoNúmero de instâncias de VM insira o número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.
  
  Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica as reservas atuais. Se houver reservas atuais que correspondam à reserva adiantada aprovada, o número de reservas atuais será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine cria. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.
  
  Cuidado: verifique se há cota suficiente para os recursos que você quer reservar. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.
- Na seção Configuração da máquina, é possível alterar os seguintes itens:
  - A série e o tipo de máquina usados nas VMs reservadas.
  - As GPUs a serem anexadas às VMs reservadas.
  - Os SSDs locais e o tipo de interface do disco das VMs reservadas.
Dependendo do status de aquisição da solicitação de reserva adiantada que você está modificando, siga um destes procedimentos:
- Para o rascunho de uma solicitação de reserva adiantada, selecione uma das seguintes opções:
  - Para salvar as mudanças, clique em Salvar rascunho.
  - Para enviar o rascunho da solicitação de reserva adiantada ao Google Cloud para análise, clique em Enviar.
- Para uma solicitação de reserva adiantada recusada, basta enviá-la para revisão clicando em Enviar.
  
  Se você enviar uma solicitação, a página Reservas vai abrir. Caso contrário, a página de detalhes da solicitação de reserva adiantada será aberta.

gcloud

Para solicitar que o Google Cloud modifique um rascunho ou uma solicitação de reserva adiantada recusada criada ao especificar propriedades diretamente, use gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome de um rascunho atual ou de uma solicitação de reserva adiantada recusada.

Opcional. Siga uma das seguintes ações:
- Para adicionar unidades de processamento gráfico (GPUs) a cada VM reservada, especifique o seguinte:
  - NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.
  - ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas.
  Verifique se o tipo de máquina especificado na solicitação de reserva futura é compatível com os tipos de GPUs especificados e se a GPU está disponível na zona em que você estiver querem reservar recursos. Caso contrário, você vai encontrar erros.
- Para remover todas as GPUs dessa solicitação de reserva adiantada, substitua a sinalização --accelerator pela sinalização --clear-accelerator.

DESCRIPTION: opcional. Uma nova descrição para o pedido de reserva adiantada.

Opcional. Siga uma das seguintes ações:
- Para adicionar ou editar o tipo de interface que você quer que os SSDs locais de cada VM usem, substitua INTERFACE_1 e INTERFACE_2. O valor precisa ser um dos indicados abaixo:
  - Se sua imagem do disco de inicialização tiver drivers NVMe otimizados, especifique nvme.
  - Caso contrário, especifique scsi.
  Cada SSD local tem 375 GB. Repita a flag --local-ssd para cada SSD local que quiser adicionar. É possível especificar no máximo 24 SSDs locais.
- Para remover todos os SSDs locais dessa solicitação de reserva adiantada, remova todas as sinalizações --local-ssd e especifique a sinalização --clear-local-ssd.
MACHINE_TYPE: opcional. Um tipo de máquina predefinido ou personalizado para usar em cada VM. Antes de especificar um tipo de máquina personalizado, analise as limitações para VMs com tipos de máquina personalizados.

Observação: se você especificar uma série de máquinas diferente da definida anteriormente, especifique um período mínimo de reserva recomendado para a série de máquinas especificada. Caso contrário, é menos provável que o Google Cloud aprove sua solicitação.
MINIMUM_CPU_PLATFORM: opcional. A plataforma de CPU mínima a ser usada em cada VM. Se você omitir a flag --min-cpu-platform, o valor dela será definido como a plataforma de CPU padrão da zona.

NAME_PREFIX: opcional. Um novo prefixo de nome para a solicitação de reserva adiantada. O nome de cada reserva criada automaticamente para essa solicitação de reserva adiantada começa com o prefixo de nome. Para ajudar a identificar as reservas criadas automaticamente para essa solicitação de reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da solicitação de reserva adiantada. Só é possível especificar SUBMITTED, que envia a solicitação de reserva adiantada ao Google Cloud para revisão.

Observação: se você estiver modificando um rascunho de solicitação de reserva adiantada e quiser salvar as alterações em vez de enviar sua solicitação ao Google Cloud para revisão, omita a Flag --planning-status.

PROJECT_ID: opcional. O ID do projeto em que a solicitação de reserva adiantada foi criada. Se você modificar uma solicitação de reserva adiantada de projeto único em uma solicitação de reserva adiantada compartilhada, esse projeto se tornará o proprietário do pedido de reserva adiantada. Se você omitir a sinalização --project, o valor será definido como o ID do projeto atual.

SHARE_SETTING: opcional. Para alterar o tipo dessa solicitação de reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma solicitação de reserva adiantada de projeto único em uma solicitação de reserva adiantada compartilhada, especifique projects. Especifique pelo menos um projeto de consumidor usando a sinalização --share-with. Caso contrário, a modificação da reserva adiantada falhará.
- Caso contrário, especifique local.
  
  Importante: se você especificar local, omita a sinalização --share-with. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
CONSUMER_PROJECT_IDS: opcional. Uma lista separada por vírgulas dos IDs de projeto com que essa solicitação de reserva adiantada pode ser compartilhada. Por exemplo, especifique project-1,project-2. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que essa solicitação de reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente para essa solicitação adiantada.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua:
- YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
- HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
O horário de início não pode ser posterior a 1 ano a partir da data e do horário em que você envia uma solicitação de reserva adiantada para análise. Para ter tempo suficiente para cancelar, excluir ou modificar uma reserva adiantada após a aprovação ou antes de entrar no horário de bloqueio, especifique um horário de início recomendado.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Outra possibilidade é substituir a flag --end-time pela flag --duration=END_DURATION, em que END_DURATION é a duração do período de reserva em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Atenção: verifique se você tem cota suficiente para os recursos que está solicitando reserva. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.

Cuidado: verifique se há cota suficiente para os recursos que você quer reservar. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.

ZONE: a zona em que a solicitação de reserva adiantada está localizada.

Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente após o horário de término do período de reserva, selecione um dos seguintes métodos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas dentro de duas horas após o horário de término (padrão), especifique a sinalização --auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, especifique as flags --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339.
- Para excluir as reservas criadas automaticamente após uma duração específica e após o horário de término do período de reserva, especifique as sinalizações --auto-delete-auto-created-reservations e --auto-created-reservations-duration.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  Substitua DURATION_BEFORE_DELETE por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.
Para impedir que o Compute Engine exclua automaticamente as reservas criadas automaticamente, especifique a flag --no-auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

Converta-o em uma solicitação de reserva adiantada de projeto único.
Desativar a opção de exclusão automática.
Reservar 100 VMs.
Envie a solicitação de reserva adiantada ao Google Cloud para aprovação.

Para modificar fr-03, execute o seguinte comando:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Para solicitar que o Google Cloud modifique um rascunho ou uma solicitação de reserva adiantada recusada criada ao especificar propriedades diretamente, faça umaPATCH solicitação ao método beta.futureReservations.update. No parâmetro de consulta updateMask, especifique cada campo que você quer atualizar. Se você precisar excluir um campo opcional da reserva, inclua esse campo no parâmetro de consulta updateMask e omita esse campo do corpo da solicitação.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Substitua:

PROJECT_ID: o ID do projeto em que a solicitação de reserva adiantada está localizada.
ZONE: a zona em que a solicitação de reserva adiantada está localizada.
FUTURE_RESERVATION_NAME: o nome de um rascunho atual ou de uma solicitação de reserva adiantada recusada. Não é possível modificar o nome de uma solicitação de reserva futura.
UPDATE_FIELDS: uma lista de campos separados por vírgulas a serem atualizados nessa solicitação PATCH. Codifique cada vírgula como %2C. Por exemplo, se você quiser atualizar os campos autoDeleteAutoCreatedReservations, totalCount e endTime em sua solicitação de reserva futura, especifique o seguinte:
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: opcional. Se você definir esse campo como true, o Compute Engine excluirá automaticamente as reservas criadas automaticamente para essa solicitação de reserva adiantada. Por padrão, o horário de exclusão é em até duas horas após o horário de término do período de reserva. Para mudar isso, siga um destes procedimentos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDeleteTime.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  Substitua DELETE_TIME por uma data e hora em que o Compute Engine exclui as reservas. A data e a hora precisam ser formatadas como carimbo de data/hora RFC 3339, que precisa ser conforme a seguir:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Substitua:
  - YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
  - HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
  - OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
- Para excluir as reservas criadas automaticamente após uma duração específica a partir do horário de início do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDuration.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604.800 segundos (7 dias).
DESCRIPTION: opcional. Para atualizar a descrição dessa solicitação de reserva futura, siga um destes procedimentos:
- Especifique uma descrição para adicionar ou atualizar.
- Para remover a descrição, exclua o campo description do corpo da solicitação e especifique-o em UPDATE_FIELDS.
NAME_PREFIX: opcional. Um novo prefixo de nome para a solicitação de reserva adiantada. O nome de cada reserva criada automaticamente para essa solicitação de reserva adiantada começa com o prefixo de nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da solicitação de reserva adiantada. Só é possível especificar SUBMITTED, que envia a solicitação de reserva adiantada ao Google Cloud para revisão.

Observação: se você estiver modificando um rascunho de solicitação de reserva adiantada e quiser salvar as alterações em vez de enviar sua solicitação ao Google Cloud para revisão, omita o campo planningStatus.
SHARE_TYPE: opcional. Para alterar o tipo de compartilhamento dessa solicitação de reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma solicitação de reserva adiantada de projeto único em uma solicitação de reserva adiantada compartilhada, especifique SPECIFIC_PROJECTS. Além disso, é preciso especificar pelo menos um projeto de consumidor no campo projects. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
- Caso contrário, especifique LOCAL. Além disso, exclua o campo projects do corpo da solicitação e especifique-o em UPDATE_FIELDS. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: opcional. Os IDs de projetos com que uma solicitação de reserva adiantada pode ser compartilhada. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que a solicitação de reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente para essa solicitação adiantada.

Opcional. Para atualizar as unidades de processamento gráfico (GPUs) anexadas a cada VM reservada, siga um destes procedimentos:
- Para adicionar ou modificar GPUs, especifique o seguinte:
  - NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.
  - ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas.
  Verifique se o tipo de máquina especificado na solicitação de reserva futura é compatível com os tipos de GPUs especificados e se a GPU está disponível na zona em que você estiver querem reservar recursos. Caso contrário, você vai encontrar erros.
- Para remover todas as GPUs dessa solicitação de reserva futura, exclua o campo guestAccelerators do corpo da solicitação e especifique-o em UPDATE_FIELDS.
Opcional. Para atualizar os SSDs locais anexados a cada VM reservada, siga um destes procedimentos:
- Para adicionar ou editar o tipo de interface que você quer que os SSDs locais de cada VM usem, substitua INTERFACE_1 e INTERFACE_2. O valor precisa ser um dos indicados abaixo:
  - Se sua imagem do disco de inicialização tiver drivers NVMe otimizados, especifique NVME.
  - Caso contrário, especifique SCSI.
  Repita os campos diskSizeGb e interface para cada SSD local que você quer adicionar ou atualizar. É possível especificar no máximo 24 SSDs locais.
- Para remover todos os SSDs locais dessa reserva de solicitação futura, exclua o campo localSsds do corpo da solicitação e especifique-o em UPDATE_FIELDS.
MACHINE_TYPE: opcional. Um tipo de máquina predefinido ou personalizado para usar em cada VM. Antes de especificar um tipo de máquina personalizado, analise as limitações para VMs com tipos de máquina personalizados.

Observação: se você especificar uma série de máquinas diferente da definida anteriormente, especifique um período mínimo de reserva recomendado para a série de máquinas especificada. Caso contrário, é menos provável que o Google Cloud aprove sua solicitação.
MINIMUM_CPU_PLATFORM: opcional. Para atualizar a plataforma mínima de CPU a ser usada em cada VM, siga um destes procedimentos:
- Para adicionar ou atualizar a plataforma mínima de CPU, especifique uma plataforma mínima.
- Para reverter à plataforma de CPU padrão da zona, exclua o campo minCpuPlatform do corpo da solicitação e especifique-o em UPDATE_FIELDS.

TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Cuidado: verifique se há cota suficiente para os recursos que você quer reservar. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339. O horário de início não pode ser posterior a 1 ano da data e do horário em que você enviar um pedido de reserva adiantada para análise. Além disso, especifique um horário de início recomendado para garantir que você tenha tempo suficiente antes que uma reserva adiantada entre no horário de bloqueio.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Como alternativa, é possível substituir o campo endTime pelo campo duration para especificar uma duração específica a partir do horário de início do período de reserva:
```
"duration": {
  "seconds": "END_DURATION"
}
```
Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.

Converta-o em uma solicitação de reserva adiantada de projeto único.
Desativar a opção de exclusão automática.
Reservar 100 VMs.
Envie a solicitação de reserva adiantada ao Google Cloud para aprovação.

Para modificar fr-03, faça a seguinte solicitação PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Depois de enviar uma solicitação de reserva adiantada ao Google Cloud para análise, confira os detalhes para monitorar o status da aquisição.

Modificar uma reserva adiantada ou aprovada

Para modificar as propriedades de uma reserva adiantada aprovada ou adquirida, selecione um dos seguintes métodos:

Modificar uma reserva adiantada aprovada ou adquirida sem revisão.

Nesta seção, explicamos como modificar a opção de exclusão automática, a descrição e o prefixo de nome em uma reserva adiantada aprovada ou adquirida sem revisão. A modificação dessas propriedades é imediata e não há limites para o número de vezes que é possível alterá-las até que o Google Cloud comece a criar as reservas.
Solicitação para modificar uma reserva adiantada aprovada ou adquirida.

Nesta seção, explicamos como solicitar que o Google Cloud modifique uma ou mais propriedades em uma reserva adiantada aprovada ou adquirida. Só é possível enviar uma solicitação para modificar uma reserva futura com um status de aquisição de Compras (PROCURING).

Modificar uma reserva aprovada ou adiantada sem revisão

Para uma reserva adiantada com um status de aquisição definido como aprovado (APPROVED) ou comprado (PROCURING), é possível modificar os campos a seguir sem aprovação do Google Cloud:

Exclusão automática
Descrição
Prefixo de nome

A modificação dessas propriedades é imediata. Até o horário de início do período de reserva de uma reserva futura, não há limites para o número de vezes que é possível modificar essas propriedades.

É possível modificar uma reserva aprovada ou adquirir uma reserva futura sem fazer uma revisão usando o console do Google Cloud, a gcloud CLI e o REST.

Console

Para modificar uma reserva adiantada aprovada ou adquirida sem revisão, siga estas etapas:

No console do Google Cloud, acesse a página Reservas.

Acessar "Reservas"
Clique na guia Reservas adiantadas.
Na coluna Nome, clique no nome da reserva adiantada que você quer modificar.

A página de detalhes da reserva adiantada selecionada é aberta.
Se você quiser modificar a opção de exclusão automática e a descrição de uma reserva adiantada, siga um ou mais destes procedimentos:
- Na linha Horário de exclusão automática de reservas criadas automaticamente, clique em Editar e siga estas etapas:
  1. Siga uma das seguintes ações:
    - Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente para sua solicitação de reserva adiantada, faça o seguinte:
      
      Atenção: se a opção de exclusão automática estiver ativada, todas as reservas criadas automaticamente serão excluídas no horário de exclusão especificado, independentemente de serem totalmente consumidas ou não.
      1. Clique no botão Ativar exclusão automática para a posição ativada.
      2. Opcional: no campo Horário da exclusão automática, insira uma nova data e hora para excluir as reservas criadas automaticamente. A data e a hora precisam ser posteriores ao horário de término do período de reserva. Se você deixar esse campo em branco, as reservas criadas automaticamente serão excluídas em até 2 horas após o horário de término do período de reserva.
    - Caso contrário, clique no botão de alternar Ativar exclusão automática para a posição desativada.
  2. Clique em Enviar.
- Na linha Prefixo, clique em Editar e faça o seguinte:
  1. No campo Prefixo, digite um novo prefixo de nome.
  2. Clique em Enviar.
- Na linha Descrição, clique em Editar e faça o seguinte:
  1. No campo Descrição, digite uma nova descrição.
  2. Clique em Enviar.

gcloud

Para modificar uma reserva adiantada aprovada ou adquirida sem revisão, use o comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --project=PROJECT_ID \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome de uma reserva adiantada aprovada ou adquirida atual.

DESCRIPTION: opcional. Uma nova descrição para a reserva adiantada.

NAME_PREFIX: opcional. Um novo prefixo de nome para a reserva adiantada. O nome de cada reserva criada automaticamente para essa reserva adiantada começa com o prefixo do nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PROJECT_ID: opcional. O ID do projeto em que a reserva adiantada foi criada.

ZONE: a zona em que a reserva adiantada está localizada.

Também é possível mudar se e quando o Compute Engine excluir automaticamente as reservas criadas automaticamente para uma reserva adiantada fazendo um dos seguintes procedimentos:

Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente após o horário de término do período de reserva, selecione um dos seguintes métodos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas dentro de duas horas após o horário de término (padrão), especifique a sinalização --auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, especifique as flags --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339.
- Para excluir as reservas criadas automaticamente após uma duração específica e após o horário de término do período de reserva, especifique as sinalizações --auto-delete-auto-created-reservations e --auto-created-reservations-duration.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  Substitua DURATION_BEFORE_DELETE por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.
Para impedir que o Compute Engine exclua automaticamente as reservas criadas automaticamente, especifique a flag --no-auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

Por exemplo, considere uma reserva adiantada aprovada chamada fr-04 e localizada na zona us-central1-a. Suponha que você queira modificar essa reserva adiantada fazendo as seguintes alterações:

Ative a opção de exclusão automática.
Excluir automaticamente as reservas criadas automaticamente após 864.000 segundos (10 dias).
Especifique um novo prefixo de nome.

Para modificar fr-04, execute o seguinte comando:

gcloud beta compute future-reservations update fr-04 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=864000 \
    --name-prefix=new-prefix \
    --project=example-project \
    --zone=us-central1-a

REST

Para modificar uma reserva adiantada aprovada ou adquirida sem revisão, faça uma solicitação PATCH ao método beta.futureReservations.update. No parâmetro de consulta updateMask, especifique cada campo que você quer atualizar. Se você precisar excluir um campo opcional da reserva, inclua esse campo no parâmetro de consulta updateMask e omita esse campo do corpo da solicitação.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX"
}

Substitua:

PROJECT_ID: o ID do projeto em que a reserva adiantada está localizada.
ZONE: a zona em que a reserva adiantada está localizada.
FUTURE_RESERVATION_NAME: o nome de uma reserva adiantada aprovada ou adquirida atual. Não é possível modificar o nome de uma reserva futura.
UPDATE_FIELDS: uma lista de campos separados por vírgulas a serem atualizados nessa solicitação PATCH. Codifique cada vírgula como %2C. Por exemplo, se você quiser atualizar os campos description e namePrefix na sua reserva futura, especifique o seguinte:
```
description%2CnamePrefix
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: opcional. Se você definir esse campo como true, o Compute Engine excluirá automaticamente as reservas criadas automaticamente para essa reserva adiantada. Por padrão, o horário de exclusão é em até duas horas após o horário de término do período de reserva. Para mudar isso, siga um destes procedimentos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDeleteTime.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  Substitua DELETE_TIME por uma data e hora em que o Compute Engine exclui as reservas. A data e a hora precisam ser formatadas como carimbo de data/hora RFC 3339, que precisa ser conforme a seguir:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Substitua:
  - YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
  - HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
  - OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
- Para excluir as reservas criadas automaticamente após uma duração específica a partir do horário de início do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDuration.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604.800 segundos (7 dias).
DESCRIPTION: opcional. Para atualizar a descrição dessa reserva futura, siga um destes procedimentos:
- Especifique uma descrição para adicionar ou atualizar.
- Para remover a descrição, exclua o campo description do corpo da solicitação e especifique-o em UPDATE_FIELDS.
NAME_PREFIX: opcional. Um novo prefixo de nome para a reserva adiantada. O nome de cada reserva criada automaticamente para essa reserva adiantada começa com o prefixo do nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

Ative a opção de exclusão automática.
Excluir automaticamente as reservas criadas automaticamente após 864.000 segundos (10 dias).
Especifique um novo prefixo de nome.

Para modificar fr-04, faça a seguinte solicitação PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "864000"
  },
  "name": "fr-04",
  "namePrefix": "new-prefix"
}

Solicitação para modificar uma reserva aprovada ou adiantada

É possível solicitar que o Google Cloud modifique uma reserva futura com um status de compra definido como "Aprovado" (APPROVED) ou "Procurando" (PROCURING) da seguinte maneira:

Se você solicitar a modificação de uma reserva adiantada aprovada, o Google Cloud realizará uma das seguintes ações:
- Aprova a solicitação e define o status de compra como "Aprovado" (APPROVED). Se o horário de início do período de reserva for em até 56 dias (oito semanas), o Compute Engine definirá o status de compra como "Em aquisição" (PROCURING) em alguns minutos.
- Recusa a solicitação e define o status da aquisição como Recusado (DECLINED). Se você quiser modificar a reserva adiantada novamente, consulte Modificar um rascunho ou recusar uma reserva adiantada neste documento.
Se você solicitar a modificação de uma reserva adiantada em aquisição, o Compute Engine criará o status de atualização na reserva adiantada e o definirá como "Atualizar aprovação pendente" (AMENDMENT_PENDING_APPROVAL). Em seguida, o Google Cloud analisará sua solicitação e realizará uma das seguintes ações:
- Aprova a solicitação e define o status da atualização como "Atualização aprovada" (AMENDMENT_APPROVED).
- Recusa a solicitação, define o status de atualização como Atualização recusada (AMENDMENT_DECLINED) e continua usando as propriedades aprovadas anteriormente para as reservas criadas automaticamente.
Durante o período em que o Google Cloud analisa sua solicitação para modificar uma reserva adiantada de aquisição, não é possível modificar nenhuma propriedade, incluindo as propriedades que você normalmente modifica sem aprovação: até que o Google Cloud aprove ou recuse a solicitação.

Para solicitar que o Google Cloud modifique as propriedades de uma reserva adiantada aprovada ou adquirida, selecione um dos seguintes métodos:

Solicitação para modificar uma reserva adiantada criada especificando um modelo de instância.

Nesta seção, explicamos como solicitar que o Google Cloud modifique uma ou mais propriedades em uma reserva adiantada aprovada e enviada criada com a especificação de um modelo de instância. Não é possível substituir o modelo de instância usado para criar a reserva adiantada ou modificar as propriedades da VM.
Solicitação para modificar uma reserva adiantada criada especificando diretamente as propriedades.

Nesta seção, explicamos como solicitar que o Google Cloud modifique uma ou mais propriedades em uma reserva adiantada enviada e aprovada criada com a especificação direta de propriedades.

Solicitação para modificar uma reserva adiantada criada especificando um modelo de instância

Para uma reserva futura criada especificando um modelo de instância com um status de compra de "Aprovado" (APPROVED) ou "compras" (PROCURING), é possível solicitar a modificação das seguintes propriedades:

Exclusão automática
Descrição
Prefixo de nome
Configurações de compartilhamento
Horário de início e término do período de reserva
Contagem total (número de VMs)^†

^† Se você solicitar para aumentar ou diminuir em grande parte a contagem total em até 14 dias a partir do horário de início da reserva futura, o Google Cloud provavelmente recusará sua solicitação.

É possível solicitar que o Google Cloud modifique uma reserva futura criada especificando um modelo de instância usando a gcloud CLI e o REST.

Console

Para solicitar que o Google Cloud modifique uma reserva adiantada aprovada ou adquirida criada ao especificar um modelo de instância, siga estas etapas:

No console do Google Cloud, acesse a página Reservas.

Acessar "Reservas"
Clique na guia Reservas adiantadas.
Na coluna Nome, clique no nome da reserva adiantada que você quer modificar.

A página de detalhes da reserva adiantada selecionada é aberta.
Se você quiser modificar a opção de exclusão automática e a descrição de uma reserva adiantada, siga um ou mais destes procedimentos:
- Na linha Horário de exclusão automática de reservas criadas automaticamente, clique em Editar e siga estas etapas:
  1. Siga uma das seguintes ações:
    - Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente para sua solicitação de reserva adiantada, faça o seguinte:
      
      Atenção: se a opção de exclusão automática estiver ativada, todas as reservas criadas automaticamente serão excluídas no horário de exclusão especificado, independentemente de serem totalmente consumidas ou não.
      1. Clique no botão Ativar exclusão automática para a posição ativada.
      2. Opcional: no campo Horário da exclusão automática, insira uma nova data e hora para excluir as reservas criadas automaticamente. A data e a hora precisam ser posteriores ao horário de término do período de reserva. Se você deixar esse campo em branco, as reservas criadas automaticamente serão excluídas em até 2 horas após o horário de término do período de reserva.
    - Caso contrário, clique no botão de alternar Ativar exclusão automática para a posição desativada.
  2. Clique em Enviar.
- Na linha Prefixo, clique em Editar e faça o seguinte:
  1. No campo Prefixo, digite um novo prefixo de nome.
  2. Clique em Enviar.
- Na linha Descrição, clique em Editar e faça o seguinte:
  1. No campo Descrição, digite uma nova descrição.
  2. Clique em Enviar.
Clique em Editar.

A página para editar a reserva adiantada selecionada é aberta.
Se você quiser modificar outras propriedades, siga um ou mais destes procedimentos:
- Modifique o Horário de início ou o Horário de término da sua reserva adiantada. Certifique-se disto:
  - O horário de início não pode ser posterior a um ano da data e do horário em que você enviou uma reserva adiantada para análise.
  - Especifique um valor recomendado para o horário de início a fim de garantir que você tenha tempo suficiente antes que sua reserva adiantada entre no horário de bloqueio.
  - Especifique um período mínimo de reserva recomendado para aumentar a probabilidade do Google Cloud aprovar sua solicitação depois de enviá-la para revisão.
- Na seção Tipo de compartilhamento, é possível selecionar Local ou Compartilhado. Se você selecionar Compartilhado, será possível adicionar ou remover projetos para compartilhar a reserva adiantada.
  
  É possível selecionar até 100 projetos. Esses projetos precisam estar na mesma organização do projeto em que a reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente e compartilhadas para essa reserva adiantada.
- Na funçãoNúmero de instâncias de VM insira o número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta reserva adiantada.
  
  Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica as reservas atuais. Se houver reservas atuais que correspondam à reserva adiantada aprovada, o número de reservas atuais será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine cria. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.
  
  Cuidado: se você quiser aumentar o número de VMs a serem reservadas, verifique se você tem cota suficiente para os recursos adicionais solicitados e reserva. Caso contrário, o Google Cloud recusará sua solicitação de modificação.
Para enviar uma solicitação de modificação ao Google Cloud para análise, clique em Enviar.

Se você enviar uma solicitação, a página Reservas vai abrir. Caso contrário, a página de detalhes da reserva adiantada será aberta.

gcloud

Para solicitar que o Google Cloud modifique uma reserva adiantada aprovada ou adquirida criada especificando um modelo de instância, use o gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome de uma reserva adiantada aprovada ou adquirida atual.

DESCRIPTION: opcional. Uma nova descrição para a reserva adiantada.

NAME_PREFIX: opcional. Um novo prefixo de nome para a reserva adiantada. O nome de cada reserva criada automaticamente para essa reserva adiantada começa com o prefixo do nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da reserva adiantada. Só é possível especificar SUBMITTED, que envia a reserva adiantada ao Google Cloud para revisão.

PROJECT_ID: opcional. O ID do projeto em que a reserva adiantada foi criada. Se você modificar uma reserva adiantada de projeto único em uma reserva adiantada compartilhada, esse projeto se tornará o proprietário da reserva adiantada. Se você omitir a sinalização --project, o valor será definido como o ID do projeto atual.

SHARE_SETTING: opcional. Para alterar o tipo dessa reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma reserva adiantada de projeto único em uma reserva adiantada compartilhada, especifique projects. Especifique pelo menos um projeto de consumidor usando a sinalização --share-with. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
- Caso contrário, especifique local.
  
  Importante: se você especificar local, omita a sinalização --share-with. Caso contrário, a modificação da reserva adiantada falhará.
CONSUMER_PROJECT_IDS: opcional. Uma lista separada por vírgulas dos IDs de projeto com que essa reserva adiantada pode ser compartilhada. Por exemplo, especifique project-1,project-2. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que essa reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente e compartilhadas para essa reserva adiantada.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua:
- YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
- HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
O horário de início não pode ser posterior a um ano da data e do horário em que você envia uma reserva adiantada para análise. Para ter tempo suficiente para cancelar, excluir ou modificar uma reserva adiantada após a aprovação ou antes de entrar no horário de bloqueio, especifique um horário de início recomendado.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Outra possibilidade é substituir a flag --end-time pela flag --duration=END_DURATION, em que END_DURATION é a duração do período de reserva em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Atenção: verifique se você tem cota suficiente para os recursos que está solicitando reserva. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.

Cuidado: se você quiser aumentar o número de VMs a serem reservadas, verifique se tem cota suficiente para os recursos adicionais que você está solicitando para reservar. Caso contrário, o Google Cloud recusará sua solicitação de modificação.

ZONE: a zona em que a reserva adiantada está localizada.

Também é possível mudar se e quando o Compute Engine excluir automaticamente as reservas criadas automaticamente para uma reserva adiantada fazendo um dos seguintes procedimentos:

Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente após o horário de término do período de reserva, selecione um dos seguintes métodos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas dentro de duas horas após o horário de término (padrão), especifique a sinalização --auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, especifique as flags --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339.
- Para excluir as reservas criadas automaticamente após uma duração específica e após o horário de término do período de reserva, especifique as sinalizações --auto-delete-auto-created-reservations e --auto-created-reservations-duration.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  Substitua DURATION_BEFORE_DELETE por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.
Para impedir que o Compute Engine exclua automaticamente as reservas criadas automaticamente, especifique a flag --no-auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

Por exemplo, considere uma reserva adiantada aprovada chamada fr-05 e localizada na zona us-central1-a. Suponha que você queira solicitar que o Google Cloud modifique essa reserva adiantada fazendo as seguintes alterações:

Mude o horário de término do período de reserva para a meia-noite de 31 de dezembro de 2023, UTC.
Reservar 10 VMs.
Especifique um novo prefixo de nome.

Para solicitar que o Google Cloud modifique fr-05, execute o seguinte comando:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Para solicitar que o Google Cloud modifique uma reserva adiantada aprovada ou adquirida criada especificando um modelo de instância, faça uma solicitação PATCH. para o método beta.futureReservations.update. No parâmetro de consulta updateMask, especifique cada campo que você quer atualizar. Se você precisar excluir um campo opcional da reserva, inclua esse campo no parâmetro de consulta updateMask e omita esse campo do corpo da solicitação.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Substitua:

PROJECT_ID: o ID do projeto em que a reserva adiantada está localizada.
ZONE: a zona em que a reserva adiantada está localizada.
FUTURE_RESERVATION_NAME: o nome de uma reserva adiantada aprovada ou adquirida atual. Não é possível modificar o nome de uma reserva futura.
UPDATE_FIELDS: uma lista de campos separados por vírgulas a serem atualizados nessa solicitação PATCH. Codifique cada vírgula como %2C. Por exemplo, se você quiser atualizar os campos autoDeleteAutoCreatedReservations, totalCount e endTime na sua reserva futura, especifique a seguinte:
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: opcional. Se você definir esse campo como true, o Compute Engine excluirá automaticamente as reservas criadas automaticamente para essa reserva adiantada. Por padrão, o horário de exclusão é em até duas horas após o horário de término do período de reserva. Para mudar isso, siga um destes procedimentos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDeleteTime.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  Substitua DELETE_TIME por uma data e hora em que o Compute Engine exclui as reservas. A data e a hora precisam ser formatadas como carimbo de data/hora RFC 3339, que precisa ser conforme a seguir:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Substitua:
  - YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
  - HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
  - OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
- Para excluir as reservas criadas automaticamente após uma duração específica a partir do horário de início do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDuration.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604.800 segundos (7 dias).
DESCRIPTION: opcional. Para atualizar a descrição dessa reserva futura, siga um destes procedimentos:
- Especifique uma descrição para adicionar ou atualizar.
- Para remover a descrição, exclua o campo description do corpo da solicitação e especifique-o em UPDATE_FIELDS.
NAME_PREFIX: opcional. Um novo prefixo de nome para a reserva adiantada. O nome de cada reserva criada automaticamente para essa reserva adiantada começa com o prefixo do nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da reserva adiantada. Só é possível especificar SUBMITTED, que envia a reserva adiantada ao Google Cloud para revisão.
SHARE_TYPE: opcional. Para alterar o tipo de compartilhamento dessa reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma reserva adiantada de projeto único em uma reserva adiantada compartilhada, especifique SPECIFIC_PROJECTS. Além disso, é preciso especificar pelo menos um projeto de consumidor no campo projects. Caso contrário, a modificação da reserva adiantada falhará.
- Caso contrário, especifique LOCAL. Além disso, exclua o campo projects do corpo da solicitação e especifique-o em UPDATE_FIELDS. Caso contrário, a modificação da reserva adiantada falhará.
CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: opcional. Os IDs de projeto com que uma reserva adiantada compartilhada pode ser compartilhada. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que a reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente e compartilhadas para essa reserva adiantada.

TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Cuidado: se você quiser aumentar o número de VMs a serem reservadas, verifique se tem cota suficiente para os recursos adicionais que você está solicitando para reservar. Caso contrário, o Google Cloud recusará sua solicitação de modificação.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339. O horário de início não pode ser posterior a um ano a partir da data e do horário em que você enviar uma reserva adiantada para análise. Além disso, especifique um horário de início recomendado para garantir que você tenha tempo suficiente antes que uma reserva adiantada entre no horário de bloqueio.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Como alternativa, é possível substituir o campo endTime pelo campo duration para especificar uma duração específica a partir do horário de início do período de reserva:
```
"duration": {
  "seconds": "END_DURATION"
}
```
Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.

Mude o horário de término do período de reserva para a meia-noite de 31 de dezembro de 2023, UTC.
Reservar 10 VMs.
Especifique um novo prefixo de nome.

Para que o Google Cloud modifique fr-05, faça a seguinte solicitação PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Depois de enviar uma solicitação para modificar uma reserva futura no Google Cloud, é possível monitorar o status da solicitação visualizando os detalhes da reserva futura.

Solicitação para modificar uma reserva adiantada criada especificando diretamente as propriedades

Para uma reserva futura criada especificando propriedades diretamente com um status de compra de "Aprovado (APPROVED)" ou "Procurando" (Procuring), é possível solicitar a modificação das seguintes propriedades:

Exclusão automática
Descrição
Prefixo de nome
GPUs^‡
SSDs locais e o tipo de interface do disco^‡
Série e tipo de máquina^‡
Plataforma mínima de CPU^‡
Configurações de compartilhamento
Horário de início e término do período de reserva
Contagem total (número de VMs)^‡

^‡ Se você solicitar a alteração de quaisquer propriedades de VM ou aumentar ou diminuir em grande parte a contagem total, dentro de 14 dias a partir do início da reserva futura é provável que o Google Cloud recuse a solicitação.

É possível solicitar que o Google Cloud modifique uma reserva futura criada especificando propriedades diretamente usando o console do Google Cloud, a gcloud CLI e o REST.

Console

Para solicitar que o Google Cloud modifique uma reserva adiantada aprovada ou adquirida criada ao especificar propriedades diretamente, siga estas etapas:

No console do Google Cloud, acesse a página Reservas.

Acessar "Reservas"
Clique na guia Reservas adiantadas.
Na coluna Nome, clique no nome da reserva adiantada que você quer modificar.

A página de detalhes da reserva adiantada selecionada é aberta.
Se você quiser modificar a opção de exclusão automática e a descrição de uma reserva adiantada, siga um ou mais destes procedimentos:
- Na linha Horário de exclusão automática de reservas criadas automaticamente, clique em Editar e siga estas etapas:
  1. Siga uma das seguintes ações:
    - Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente para sua solicitação de reserva adiantada, faça o seguinte:
      
      Atenção: se a opção de exclusão automática estiver ativada, todas as reservas criadas automaticamente serão excluídas no horário de exclusão especificado, independentemente de serem totalmente consumidas ou não.
      1. Clique no botão Ativar exclusão automática para a posição ativada.
      2. Opcional: no campo Horário da exclusão automática, insira uma nova data e hora para excluir as reservas criadas automaticamente. A data e a hora precisam ser posteriores ao horário de término do período de reserva. Se você deixar esse campo em branco, as reservas criadas automaticamente serão excluídas em até 2 horas após o horário de término do período de reserva.
    - Caso contrário, clique no botão de alternar Ativar exclusão automática para a posição desativada.
  2. Clique em Enviar.
- Na linha Prefixo, clique em Editar e faça o seguinte:
  1. No campo Prefixo, digite um novo prefixo de nome.
  2. Clique em Enviar.
- Na linha Descrição, clique em Editar e faça o seguinte:
  1. No campo Descrição, digite uma nova descrição.
  2. Clique em Enviar.
Clique em Editar.

A página para editar a reserva adiantada selecionada é aberta.
Se você quiser modificar outras propriedades, siga um ou mais destes procedimentos:
- Modifique o Horário de início ou o Horário de término da sua reserva adiantada. Certifique-se disto:
  - O horário de início não pode ser posterior a um ano da data e do horário em que você enviou uma reserva adiantada para análise.
  - Especifique um valor recomendado para o horário de início a fim de garantir que você tenha tempo suficiente antes que sua reserva adiantada entre no horário de bloqueio.
  - Especifique um período mínimo de reserva recomendado para aumentar a probabilidade do Google Cloud aprovar sua solicitação depois de enviá-la para revisão.
- Na seção Tipo de compartilhamento, é possível selecionar Local ou Compartilhado. Se você selecionar Compartilhado, será possível adicionar ou remover projetos para compartilhar a reserva adiantada.
  
  É possível selecionar até 100 projetos. Esses projetos precisam estar na mesma organização do projeto em que a reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente e compartilhadas para essa reserva adiantada.
- Na funçãoNúmero de instâncias de VM insira o número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta reserva adiantada.
  
  Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica as reservas atuais. Se houver reservas atuais que correspondam à reserva adiantada aprovada, o número de reservas atuais será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine cria. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.
  
  Cuidado: se você quiser aumentar o número de VMs a serem reservadas, verifique se você tem cota suficiente para os recursos adicionais solicitados e reserva. Caso contrário, o Google Cloud recusará sua solicitação de modificação.
- Na seção Configuração da máquina, é possível alterar os seguintes itens:
  - A série e o tipo de máquina usados nas VMs reservadas.
  - As GPUs a serem anexadas às VMs reservadas.
  - Os SSDs locais e o tipo de interface do disco das VMs reservadas.
Para enviar uma solicitação de modificação ao Google Cloud para análise, clique em Enviar.

Se você enviar uma solicitação, a página Reservas vai abrir. Caso contrário, a página de detalhes da reserva adiantada será aberta.

gcloud

Para solicitar que o Google Cloud modifique uma reserva adiantada aprovada ou adquirida criada ao especificar propriedades diretamente, use o comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome de uma reserva adiantada aprovada ou adquirida atual.

Opcional. Siga uma das seguintes ações:
- Para adicionar unidades de processamento gráfico (GPUs) a cada VM reservada, especifique o seguinte:
  - NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.
  - ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas.
  Verifique se o tipo de máquina especificado na reserva futura é compatível com os tipos de GPUs definidos e se a GPU está disponível na zona em que você quer. para reservar recursos. Caso contrário, você vai encontrar erros.
- Para remover todas as GPUs dessa solicitação adiantada, substitua a sinalização --accelerator pela sinalização --clear-accelerator.

DESCRIPTION: opcional. Uma nova descrição para a reserva adiantada.

Opcional. Siga uma das seguintes ações:
- Para adicionar ou editar o tipo de interface que você quer que os SSDs locais de cada VM usem, substitua INTERFACE_1 e INTERFACE_2. O valor precisa ser um dos indicados abaixo:
  - Se sua imagem do disco de inicialização tiver drivers NVMe otimizados, especifique nvme.
  - Caso contrário, especifique scsi.
  Cada SSD local tem 375 GB. Repita a flag --local-ssd para cada SSD local que quiser adicionar. É possível especificar no máximo 24 SSDs locais.
- Para remover todos os SSDs locais dessa reserva adiantada, remova todas as sinalizações --local-ssd e especifique a sinalização --clear-local-ssd.
MACHINE_TYPE: opcional. Um tipo de máquina predefinido ou personalizado para usar em cada VM. Antes de especificar um tipo de máquina personalizado, analise as limitações para VMs com tipos de máquina personalizados.

Observação: se você especificar uma série de máquinas diferente da definida anteriormente, especifique um período mínimo de reserva recomendado para a série de máquinas especificada. Caso contrário, é menos provável que o Google Cloud aprove sua solicitação.
MINIMUM_CPU_PLATFORM: opcional. A plataforma de CPU mínima a ser usada em cada VM. Se você omitir a flag --min-cpu-platform, o valor dela será definido como a plataforma de CPU padrão da zona.

NAME_PREFIX: opcional. Um novo prefixo de nome para a reserva adiantada. O nome de cada reserva criada automaticamente para essa reserva adiantada começa com o prefixo do nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da reserva adiantada. Só é possível especificar SUBMITTED, que envia a reserva adiantada ao Google Cloud para revisão.

PROJECT_ID: opcional. O ID do projeto em que a reserva adiantada foi criada. Se você modificar uma reserva adiantada de projeto único em uma reserva adiantada compartilhada, esse projeto se tornará o proprietário da reserva adiantada. Se você omitir a sinalização --project, o valor será definido como o ID do projeto atual.

SHARE_SETTING: opcional. Para alterar o tipo dessa reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma reserva adiantada de projeto único em uma reserva adiantada compartilhada, especifique projects. Especifique pelo menos um projeto de consumidor usando a sinalização --share-with. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
- Caso contrário, especifique local.
  
  Importante: se você especificar local, omita a sinalização --share-with. Caso contrário, a modificação da reserva adiantada falhará.
CONSUMER_PROJECT_IDS: opcional. Uma lista separada por vírgulas dos IDs de projeto com que essa reserva adiantada pode ser compartilhada. Por exemplo, especifique project-1,project-2. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que essa reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente e compartilhadas para essa reserva adiantada.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Substitua:
- YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
- HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
- OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
O horário de início não pode ser posterior a um ano da data e do horário em que você envia uma reserva adiantada para análise. Para ter tempo suficiente para cancelar, excluir ou modificar uma reserva adiantada após a aprovação ou antes de entrar no horário de bloqueio, especifique um horário de início recomendado.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Outra possibilidade é substituir a flag --end-time pela flag --duration=END_DURATION, em que END_DURATION é a duração do período de reserva em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.
TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Atenção: verifique se você tem cota suficiente para os recursos que está solicitando reserva. Caso contrário, o Google Cloud recusará sua solicitação de reserva adiantada.

Cuidado: se você quiser aumentar o número de VMs a serem reservadas, verifique se tem cota suficiente para os recursos adicionais que você está solicitando para reservar. Caso contrário, o Google Cloud recusará sua solicitação de modificação.

ZONE: a zona em que a reserva adiantada está localizada.

Também é possível mudar se e quando o Compute Engine excluir automaticamente as reservas criadas automaticamente para uma reserva adiantada fazendo um dos seguintes procedimentos:

Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente após o horário de término do período de reserva, selecione um dos seguintes métodos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas dentro de duas horas após o horário de término (padrão), especifique a sinalização --auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations
```
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, especifique as flags --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
```
  Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339.
- Para excluir as reservas criadas automaticamente após uma duração específica e após o horário de término do período de reserva, especifique as sinalizações --auto-delete-auto-created-reservations e --auto-created-reservations-duration.
```
gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE
```
  Substitua DURATION_BEFORE_DELETE por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.
Para impedir que o Compute Engine exclua automaticamente as reservas criadas automaticamente, especifique a flag --no-auto-delete-auto-created-reservations.
```
gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations
```

Mude o horário de término do período de reserva para a meia-noite de 31 de dezembro de 2023, UTC.
Reservar 10 VMs.
Especifique um novo prefixo de nome.

Para solicitar que o Google Cloud modifique fr-05, execute o seguinte comando:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Para solicitar que o Google Cloud modifique uma reserva adiantada aprovada ou adquirida criada ao especificar propriedades diretamente, faça umaPATCH solicitação ao método beta.futureReservations.update. No parâmetro de consulta updateMask, especifique cada campo que você quer atualizar. Se você precisar excluir um campo opcional da reserva, inclua esse campo no parâmetro de consulta updateMask e omita esse campo do corpo da solicitação.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Substitua:

PROJECT_ID: o ID do projeto em que a reserva adiantada está localizada.
ZONE: a zona em que a reserva adiantada está localizada.
FUTURE_RESERVATION_NAME: o nome de uma reserva adiantada aprovada ou adquirida atual. Não é possível modificar o nome de uma reserva futura.
UPDATE_FIELDS: uma lista de campos separados por vírgulas a serem atualizados nessa solicitação PATCH. Codifique cada vírgula como %2C. Por exemplo, se você quiser atualizar os campos autoDeleteAutoCreatedReservations, totalCount e endTime na sua reserva futura, especifique a seguinte:
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: opcional. Se você definir esse campo como true, o Compute Engine excluirá automaticamente as reservas criadas automaticamente para essa reserva adiantada. Por padrão, o horário de exclusão é em até duas horas após o horário de término do período de reserva. Para mudar isso, siga um destes procedimentos:

Atenção: se você ativar a opção de exclusão automática, todas as reservas criadas automaticamente serão excluídas no horário especificado, independentemente de serem totalmente consumidas ou não.
- Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDeleteTime.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}
```
  Substitua DELETE_TIME por uma data e hora em que o Compute Engine exclui as reservas. A data e a hora precisam ser formatadas como carimbo de data/hora RFC 3339, que precisa ser conforme a seguir:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Substitua:
  - YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos, separados por hífens (-).
  - HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).
  - OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Outra possibilidade é não usar ajuste: especifique Z.
- Para excluir as reservas criadas automaticamente após uma duração específica a partir do horário de início do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDuration.
```
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}
```
  Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604.800 segundos (7 dias).
DESCRIPTION: opcional. Para atualizar a descrição dessa reserva futura, siga um destes procedimentos:
- Especifique uma descrição para adicionar ou atualizar.
- Para remover a descrição, exclua o campo description do corpo da solicitação e especifique-o em UPDATE_FIELDS.
NAME_PREFIX: opcional. Um novo prefixo de nome para a reserva adiantada. O nome de cada reserva criada automaticamente para essa reserva adiantada começa com o prefixo do nome. Para ajudar a identificar as reservas criadas automaticamente para essa reserva adiantada, é recomendável especificar um prefixo de nome exclusivo.

PLANNING_STATUS: o status de planejamento da reserva adiantada. Só é possível especificar SUBMITTED, que envia a reserva adiantada ao Google Cloud para revisão.
SHARE_TYPE: opcional. Para alterar o tipo de compartilhamento dessa reserva adiantada, especifique um dos seguintes valores:
- Para alterar uma reserva adiantada de projeto único em uma reserva adiantada compartilhada, especifique SPECIFIC_PROJECTS. Além disso, é preciso especificar pelo menos um projeto de consumidor no campo projects. Caso contrário, a modificação da reserva adiantada falhará.
- Caso contrário, especifique LOCAL. Além disso, exclua o campo projects do corpo da solicitação e especifique-o em UPDATE_FIELDS. Caso contrário, a modificação da reserva adiantada falhará.
CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: opcional. Os IDs de projeto com que uma reserva adiantada compartilhada pode ser compartilhada. Você pode informar até cem projetos. Esses projetos precisam estar na mesma organização do projeto em que a reserva adiantada foi criada (o projeto do proprietário). Não especifique o projeto do proprietário. Por padrão, é permitido consumir as reservas criadas automaticamente e compartilhadas para essa reserva adiantada.

Opcional. Para atualizar as unidades de processamento gráfico (GPUs) anexadas a cada VM reservada, siga um destes procedimentos:
- Para adicionar ou modificar GPUs, especifique o seguinte:
  - NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.
  - ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas.
  Verifique se o tipo de máquina especificado na reserva futura é compatível com os tipos de GPUs definidos e se a GPU está disponível na zona em que você quer. para reservar recursos. Caso contrário, você vai encontrar erros.
- Para remover todas as GPUs dessa solicitação futura, omita o campo guestAccelerators no corpo da solicitação e especifique-o em UPDATE_FIELDS.
Opcional. Para atualizar os SSDs locais anexados a cada VM reservada, siga um destes procedimentos:
- Para adicionar ou editar o tipo de interface que você quer que os SSDs locais de cada VM usem, substitua INTERFACE_1 e INTERFACE_2. O valor precisa ser um dos indicados abaixo:
  - Se sua imagem do disco de inicialização tiver drivers NVMe otimizados, especifique NVME.
  - Caso contrário, especifique SCSI.
  Repita os campos diskSizeGb e interface para cada SSD local que você quer adicionar ou atualizar. É possível especificar no máximo 24 SSDs locais.
- Para remover todos os SSDs locais dessa reserva futura, exclua o campo localSsds do corpo da solicitação e especifique-o em UPDATE_FIELDS.
MACHINE_TYPE: opcional. Um tipo de máquina predefinido ou personalizado para usar em cada VM. Antes de especificar um tipo de máquina personalizado, analise as limitações para VMs com tipos de máquina personalizados.

Observação: se você especificar uma série de máquinas diferente da definida anteriormente, especifique um período mínimo de reserva recomendado para a série de máquinas especificada. Caso contrário, é menos provável que o Google Cloud aprove sua solicitação.
MINIMUM_CPU_PLATFORM: opcional. Para atualizar a plataforma mínima de CPU a ser usada em cada VM, siga um destes procedimentos:
- Para adicionar ou atualizar a plataforma mínima de CPU, especifique uma plataforma mínima.
- Para reverter à plataforma de CPU padrão da zona, exclua o campo minCpuPlatform do corpo da solicitação e especifique-o em UPDATE_FIELDS.

TOTAL_COUNT: opcional. O novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada.

Ao calcular o número de reservas a serem criadas para uma reserva adiantada aprovada, o Compute Engine primeiro verifica se já existem reservas. Se já existirem reservas correspondentes à reserva adiantada aprovada, o número de reservas existentes será subtraído do número total solicitado de reservas na solicitação para determinar o número de novas reservas que o Compute Engine criará. Para mais informações, veja como o Compute Engine conta e provisiona recursos reservados.

Cuidado: se você quiser aumentar o número de VMs a serem reservadas, verifique se tem cota suficiente para os recursos adicionais que você está solicitando para reservar. Caso contrário, o Google Cloud recusará sua solicitação de modificação.
START_TIME: opcional. O novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339. O horário de início não pode ser posterior a um ano a partir da data e do horário em que você enviar uma reserva adiantada para análise. Além disso, especifique um horário de início recomendado para garantir que você tenha tempo suficiente antes que uma reserva adiantada entre no horário de bloqueio.
END_TIME: opcional. O novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Como alternativa, é possível substituir o campo endTime pelo campo duration para especificar uma duração específica a partir do horário de início do período de reserva:
```
"duration": {
  "seconds": "END_DURATION"
}
```
Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

Para aumentar as chances de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um dos valores recomendados para o período de reserva.

Importante: verifique se o período de reserva não se sobrepõe ao período de reserva de outra solicitação de reserva futura atual com zonas e propriedades de VM correspondentes. Além disso, verifique se foi criado ou é compartilhado com seu projeto atual. Caso contrário, a modificação da solicitação de reserva adiantada falhará.

Mude o horário de término do período de reserva para a meia-noite de 31 de dezembro de 2023, UTC.
Reservar 10 VMs.
Especifique um novo prefixo de nome.

Para que o Google Cloud modifique fr-05, faça a seguinte solicitação PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Depois de enviar uma solicitação para modificar uma reserva futura no Google Cloud, é possível monitorar o status da solicitação visualizando os detalhes da reserva futura.

Alterar outras propriedades em uma solicitação de reserva adiantada

Se você quiser alterar outras propriedades em uma solicitação de reserva adiantada antes que ela alcance o status de aquisição (PROCURING), siga estas etapas:

Fazer um ou mais dos seguintes:
- Para impedir que o Google Cloud analise a solicitação de reserva adiantada, cancele a solicitação de reserva adiantada.
- Para impedir que a solicitação de reserva adiantada restrinja o tipo de solicitações de reserva adiantadas que você pode criar no projeto atual ou nos projetos com os quais a solicitação de reserva adiantada é compartilhada, exclua a solicitação de reserva adiantada.
Crie um novo projeto único ou uma solicitação de reserva adiantada compartilhada com as atualizações que você quiser.

Resolver problemas

Se você encontrar erros ao modificar uma solicitação de reserva adiantada, saiba como solucionar problemas de solicitações de reserva adiantadas.

Se você ainda encontrar problemas após a solução de problemas, entre em contato com o representante da conta ou com o suporte do Google Cloud.

Cancelar solicitações adiantadas de reserva

É possível cancelar uma solicitação de reserva adiantada aprovada, recusada ou pendente para impedir que o Google Cloud provisione a capacidade solicitada. Depois de cancelar uma solicitação de reserva adiantada, só será possível visualizar os detalhes ou excluí-la.

É possível cancelar uma solicitação de reserva futura usando a gcloud CLI e a REST.

gcloud

Para cancelar uma solicitação de reserva adiantada, use o comando gcloud beta compute future-reservations cancel.

gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome de uma solicitação de reserva adiantada atual.
PROJECT_ID: opcional. O ID do projeto em que a solicitação de reserva adiantada está localizada. Se você omitir a flag --project, o ID do projeto atual será usado.
ZONE: a zona em que a solicitação de reserva adiantada está localizada.

REST

Para cancelar uma solicitação de reserva adiantada, faça uma solicitação POST para o método beta.futureReservations.cancel.

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

Substitua:

PROJECT_ID: o ID do projeto em que a solicitação de reserva adiantada está localizada.
ZONE: a zona em que a solicitação de reserva adiantada está localizada.
FUTURE_RESERVATION_NAME: o nome de uma solicitação de reserva adiantada atual.

Excluir solicitações de reserva adiantada

Só é possível excluir uma solicitação de reserva adiantada em um dos seguintes casos:

A solicitação de reserva adiantada foi cancelada.
Antes que a reserva adiantada atinja o horário de início do período de reserva.
Depois que a reserva adiantada atinge o horário de término do período de reserva.

A exclusão de uma reserva adiantada não remove as reservas criadas automaticamente para a reserva adiantada. Se você quiser excluir uma reserva criada automaticamente após o término do período de reserva, consulte Excluir reservas.

É possível excluir uma solicitação de reserva futura usando o console do Google Cloud, a gcloud CLI e o REST.

Console

Para excluir uma solicitação de reserva adiantada, siga estas etapas:

No console do Google Cloud, acesse a página Reservas.

Acessar "Reservas"
Clique na guia Reservas adiantadas.
Marque a caixa de seleção ao lado de cada solicitação de reserva adiantada que você quiser excluir.
Clique em Excluir reserva.
Para confirmar, clique em Excluir.

A exclusão de uma solicitação de reserva adiantada pode levar até um minuto para ser concluída.

gcloud

Para excluir uma solicitação de reserva adiantada, use o comando gcloud beta compute future-reservations delete.

gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome de uma solicitação de reserva adiantada atual.
PROJECT_ID: opcional. O ID do projeto em que a solicitação de reserva adiantada está localizada. Se você omitir a flag --project, o ID do projeto atual será usado.
ZONE: a zona em que a solicitação de reserva adiantada está localizada.

REST

Para excluir uma solicitação de reserva adiantada, faça uma solicitação DELETE para o método beta.futureReservations.delete.

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

Substitua:

PROJECT_ID: o ID do projeto em que a solicitação de reserva adiantada está localizada.
ZONE: a zona em que a solicitação de reserva adiantada está localizada.
FUTURE_RESERVATION_NAME: o nome de uma solicitação de reserva adiantada atual.

A seguir

Saiba como visualizar solicitações de reserva adiantadas.
Depois de atingir o horário de início do período de reserva, saiba como consumir as reservas criadas automaticamente.
Após o horário de término do período de reserva, saiba como fazer o seguinte:
- Modifique as reservas criadas automaticamente.
- Exclua as reservas criadas automaticamente.