Cancelar ou excluir solicitações de reserva adiantada

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 o pedido cancelado 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 é permanente e remove todas as restrições à criação de novas solicitações.

Depois que uma reserva adiantada concluída atingir o fim do período de reserva, será possível excluí-la para remover as restrições à 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 serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se 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 console Google Cloud para acessar os serviços e as APIs Google Cloud , não é necessário configurar a autenticação.

    gcloud

    1. Instale a CLI do Google Cloud. 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.

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

      Instale a CLI do Google Cloud.

      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 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 de reserva adiantada

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

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

  • O pedido foi aprovado, mas o estado dele 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:

Console

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

    Acesse "Reservas"

  2. Clique na guia Reservas adiantadas.

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

  4. Clique em Cancelar.

  5. Para confirmar, clique em Cancelar. O cancelamento de uma solicitação de reserva pode levar alguns minutos para ser concluído.

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:

  • O pedido ainda não atingiu o tempo de bloqueio (PROCURING) e não está com aprovação pendente.

  • A solicitação foi atendida e o período de reserva terminou.

Para excluir uma solicitação de reserva adiantada pendente de aprovação, cancele 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 consoleGoogle 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.

    Acesse "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