Este documento descreve 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 a exclui permanentemente e remove todas as restrições na criação de novas solicitações.
Depois que uma reserva adiantada atendida atingir o final do período de reserva, será possível excluí-la para remover todas as restrições na 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.
Com isso, você confirma sua identidade para acesso a Google Cloud serviços e APIs do. Para executar
código ou amostras de um ambiente de desenvolvimento local, faça a autenticação no
Compute Engine selecionando uma das seguintes opções:
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.
gcloud
-
Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
-
- Defina uma região e uma zona padrão.
REST
Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a Google Cloud CLI.
Saiba mais em 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 seu administrador para conceder a você oAdministrador da reserva adiantada do Compute (roles/compute.futureReservationAdmin) Papel do IAM 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.cancelno projeto -
Para excluir uma reserva adiantada:
compute.futureReservations.deleteno projeto
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Cancelar solicitações de reserva futura
Só é possível cancelar uma solicitação de reserva adiantada nos seguintes casos:
A solicitação está pendente de aprovação ou foi recusada.
A solicitação foi aprovada, mas o estado dela ainda não mudou para
PROCURING.
Depois de cancelar uma solicitação de reserva adiantada, só será possível visualizar os detalhes ou excluí-la.
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 compute future-reservations cancel.
gcloud 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 futureReservations.cancel.
POST https://compute.googleapis.com/compute/v1/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 horário de bloqueio (
PROCURING) e não está pendente de aprovação.A solicitação foi atendida e o período de reserva dela terminou.
Para excluir uma solicitação de reserva adiantada que está pendente de aprovação, é necessário cancelar a solicitação antes de excluí-la.
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 Google Cloud console. Caso contrário, para excluir uma única solicitação de reserva adiantada, selecione uma das seguintes opções:
Console
No Google Cloud console, acesse a página Reservas.
Clique na guia Reservas adiantadas.
Selecione cada solicitação de reserva adiantada que você quer 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 compute future-reservations delete.
gcloud 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 futureReservations.delete.
DELETE https://compute.googleapis.com/compute/v1/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.