Cancelar ou excluir solicitações de reserva adiantada

---

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Neste documento, explicamos como cancelar ou excluir solicitações de reserva adiantada.

Antes que uma solicitação de reserva adiantada chegue ao horário de bloqueio, é possível impedir que o Compute Engine provisione os recursos solicitados fazendo uma destas ações:

• Cancelar a solicitação de reserva adiantada. Isso é útil para manter a solicitação cancelada como referência ao criar novas solicitações. No entanto, uma solicitação de reserva adiantada cancelada impede que você crie novas solicitações com propriedades que correspondam à solicitação cancelada no seu projeto ou nos projetos com os quais a solicitação é compartilhada até que ela seja excluída. Para mais informações, consulte Restrições na criação.

• Excluir a solicitação de reserva adiantada. Isso é útil quando você não precisa mais da solicitação. A exclusão de uma solicitação de reserva adiantada exclui-a permanentemente e remove todas as restrições para criar novas solicitações.

Depois que uma reserva adiantada atendida chegar ao fim do período de reserva, ela poderá ser excluída para remover as restrições de criação de novas solicitações. No entanto, a exclusão de uma reserva adiantada atendida não remove as reservas criadas automaticamente. Para excluir uma reserva criada automaticamente após o término do período de reserva, consulte Excluir reservas.

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.
  

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

  Console

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

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

Funções exigidas

Para receber as permissões necessárias para cancelar ou excluir solicitações de reserva adiantada, peça ao administrador para conceder a você o papel do IAM de Administrador da reserva adiantada do Compute (roles/compute.futureReservationAdmin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para cancelar ou excluir solicitações de reserva adiantada. 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 cancelar ou excluir solicitações de reserva adiantada:

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

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

Cancelar solicitações adiantadas de reserva

Só é possível cancelar uma reserva adiantada nos seguintes casos:

• A solicitação está pendente de aprovação ou foi recusada.

• A solicitação foi aprovada, mas ainda não atingiu o tempo de bloqueio.

Depois de cancelar uma solicitação de reserva adiantada, só será possível acessar os detalhes da solicitação ou excluí-la.

Importante: enquanto uma solicitação cancelada existir, você não poderá criar novas solicitações com propriedades que correspondam às solicitações canceladas no seu projeto ou em qualquer um dos projetos com os quais a solicitação cancelada é compartilhada. Para criar novas solicitações com propriedades que correspondem à solicitação cancelada, exclua a solicitação cancelada antes de criar novas.

Para cancelar uma solicitação de reserva adiantada, selecione uma das seguintes opções:

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 \
    --zone=ZONE

Substitua:

• FUTURE_RESERVATION_NAME: o nome de uma solicitação de reserva adiantada atual.

• 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 da solicitação de reserva adiantada.

Excluir solicitações de reserva adiantada

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

• A solicitação ainda não atingiu o tempo de bloqueio e não está pendente de aprovação.

• O pedido foi atendido e o período de reserva dele acabou.

Para excluir uma solicitação de reserva adiantada que está pendente de aprovação, é necessário cancelar a solicitação antes de excluir.

A exclusão de uma reserva adiantada atendida não remove as reservas criadas automaticamente. Para excluir uma reserva criada automaticamente após o término do período de reserva, consulte Excluir reservas.

Para excluir várias solicitações de reserva adiantada ao mesmo tempo, use o console do Google Cloud. Para excluir uma única solicitação de reserva adiantada, selecione uma das seguintes opções:

Console

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

   Acessar "Reservas"

2. Clique na guia Reservas adiantadas.

3. Selecione cada solicitação de reserva adiantada que você quer excluir.

4. Clique em Excluir reserva.

5. 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 \
    --zone=ZONE

Substitua:

• FUTURE_RESERVATION_NAME: o nome de uma solicitação de reserva adiantada atual.

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