Cancelar ou excluir futuras solicitações de reserva


Este documento descreve como cancelar ou excluir futuras solicitações de reserva.

Antes que uma solicitação de reserva futura atinja o tempo de bloqueio , você pode impedir que o Compute Engine provisione os recursos solicitados seguindo um destes procedimentos:

  • Cancelar o pedido de reserva futura . Isto é útil para manter a solicitação cancelada como referência ao criar novas solicitações. No entanto, uma solicitação de reserva futura 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 você a exclua. Para obter mais informações, consulte Restrições à criação .

  • Exclua a solicitação de reserva futura . Isto é útil quando você não precisa mais da solicitação. Excluir uma solicitação de reserva futura a exclui permanentemente e remove quaisquer restrições à criação de novas solicitações.

Depois que uma reserva futura atendida chegar ao final do período de reserva, você poderá excluí-la para remover quaisquer restrições à criação de novas solicitações. No entanto, a exclusão de uma reserva futura cumprida não exclui 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

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:

    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. After installing the Google Cloud CLI, initialize it by running the following command:

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.
    3. REST

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

        After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Funções obrigatórias

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

Esta função predefinida contém as permissões necessárias para cancelar ou excluir futuras solicitações de reserva. Para ver 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 futuras solicitações de reserva:

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

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Cancelar futuras solicitações de reserva

Você só poderá cancelar uma reserva futura 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.

Após cancelar um pedido de reserva futuro, você só poderá visualizar os detalhes do pedido ou excluí-lo .

Para cancelar um pedido de reserva futuro, selecione uma das seguintes opções:

gcloud

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

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

Substitua o seguinte:

  • FUTURE_RESERVATION_NAME : o nome de uma solicitação de reserva futura existente.

  • ZONE : a zona onde se encontra o futuro pedido de reserva.

DESCANSAR

Para cancelar uma solicitação de reserva futura, 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 o seguinte:

  • PROJECT_ID : o ID do projeto onde está localizada a futura solicitação de reserva.

  • ZONE : a zona onde se encontra o futuro pedido de reserva.

  • FUTURE_RESERVATION_NAME : o nome da futura solicitação de reserva.

Excluir futuras solicitações de reserva

Você só poderá excluir uma solicitação de reserva futura nos seguintes casos:

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

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

Para excluir uma solicitação de reserva futura que esteja com aprovação pendente, você deverá cancelar a solicitação antes de excluí-la.

Excluir uma reserva futura cumprida não exclui 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 futuras simultaneamente, use o console do Google Cloud. Caso contrário, para eliminar um único pedido de reserva futura, selecione qualquer uma das seguintes opções:

Console

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

    Ir para Reservas

  2. Clique na guia Reservas futuras .

  3. Selecione cada solicitação de reserva futura que você deseja excluir.

  4. Clique em Excluir reserva .

  5. Para confirmar, clique em Excluir .

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

gcloud

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

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

Substitua o seguinte:

  • FUTURE_RESERVATION_NAME : o nome de uma solicitação de reserva futura existente.

  • ZONE : a zona onde se encontra o futuro pedido de reserva.

DESCANSAR

Para excluir uma solicitação de reserva futura, 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 o seguinte:

  • PROJECT_ID : o ID do projeto onde está localizada a futura solicitação de reserva.

  • ZONE : a zona onde se encontra o futuro pedido de reserva.

  • FUTURE_RESERVATION_NAME : o nome de uma solicitação de reserva futura existente.

O que vem a seguir