Cancelar ou excluir solicitações de reserva adiantada

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 atinge o final do período de reserva, é 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 exemplos de um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com uma destas 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

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

     gcloud init

     Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

     Observação: se você já tiver instalado a CLI gcloud, verifique se você tem a versão mais recente executando gcloud components update.
• 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.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

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ê o Administrador 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.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 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.

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

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

1. No Google Cloud console, 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 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.