Excluir uma solicitação de reserva adiantada no modo de calendário

Neste documento, explicamos como cancelar ou excluir permanentemente uma solicitação de reserva adiantada no modo de calendário.

Se você não precisar mais de uma solicitação de reserva adiantada no modo de calendário, faça uma ou ambas as ações a seguir:

  • Cancele a solicitação de reserva: é possível cancelar uma solicitação para impedir que o Compute Engine provisione os recursos solicitados e incorra em cobranças por eles. Depois de cancelar uma solicitação, você pode manter o pedido para referência futura ou excluí-lo.

  • Exclua a solicitação de reserva: depois de cancelar uma solicitação ou quando ela atingir o horário de término, você poderá excluir permanentemente a solicitação para remover o registro do seu projeto.

Somente o projeto proprietário, em que uma solicitação existe, pode cancelar ou excluir uma solicitação compartilhada. Para saber mais sobre os requisitos e limitações aplicados ao cancelar ou excluir uma solicitação no modo de calendário, consulte Sobre solicitações de reserva adiantada no modo de calendário.

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 Cloud de Confiance by S3NS . 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 Cloud de Confiance para acessar serviços Cloud de Confiance by S3NS e APIs, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, 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 nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Cloud de Confiance .

Funções exigidas

Para receber as permissões necessárias para cancelar ou excluir solicitações de reserva adiantada no modo de calendário, 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 no modo de calendário. Para acessar 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 no modo de agenda:

  • Para cancelar uma solicitação de reserva adiantada: compute.futureReservations.cancel no projeto
  • Para excluir uma solicitação de 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 uma solicitação de reserva adiantada no modo de calendário

É possível cancelar uma solicitação de reserva adiantada no modo de agenda se ela atender a uma das seguintes condições:

  • O horário de início está a mais de 30 dias.

  • Você cancela o pedido em até 24 horas após a aprovação, e o horário de início está a pelo menos quatro dias de distância.

Depois de cancelar a solicitação, o Compute Engine exclui a reserva vazia criada para ela. Você pode ver os detalhes da solicitação ou excluí-la.

Para cancelar várias solicitações de reserva adiantada no modo de calendário, use o consoleCloud de Confiance . Para cancelar uma única solicitação, selecione uma das seguintes opções:

Console

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

    Acesse "Reservas"

  2. Clique na guia Reservas adiantadas.

  3. Selecione cada solicitação de reserva adiantada no modo de calendário 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 no modo de calendário, use o comando gcloud compute future-reservations cancel:

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

Substitua:

  • FUTURE_RESERVATION_NAME: o nome da sua solicitação de reserva adiantada no modo de calendário.

  • ZONE: a zona em que a solicitação está.

REST

Para cancelar uma solicitação de reserva adiantada no modo de calendário, faça uma solicitação POST para o método futureReservations.cancel:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

Substitua:

  • PROJECT_ID: o ID do projeto em que sua solicitação de reserva adiantada no modo de calendário existe.

  • ZONE: a zona em que a solicitação está.

  • FUTURE_RESERVATION_NAME: o nome da sua solicitação.

Excluir uma solicitação de reserva adiantada no modo de calendário

Só é possível excluir uma solicitação de reserva adiantada no modo de calendário depois que uma das seguintes situações ocorrer:

  • A solicitação está no estado CANCELLED.

  • A solicitação atingiu o horário de término.

Para excluir várias solicitações de reserva adiantada no modo de calendário simultaneamente, use o console Cloud de Confiance . Para excluir uma única solicitação, selecione uma das seguintes opções:

Console

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

    Acesse "Reservas"

  2. Clique na guia Reservas adiantadas.

  3. Selecione cada solicitação de reserva adiantada no modo de calendário que você quer excluir.

  4. Clique em Excluir.

  5. Para confirmar, clique em Excluir. A exclusão de uma solicitação pode levar até um minuto para ser concluída.

gcloud

Para excluir uma solicitação de reserva adiantada no modo de calendário, use o comando gcloud compute future-reservations delete:

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

Substitua:

  • FUTURE_RESERVATION_NAME: o nome da sua solicitação de reserva adiantada no modo de calendário.

  • ZONE: a zona em que a solicitação está.

REST

Para excluir uma solicitação de reserva adiantada no modo de calendário, faça uma solicitação DELETE para o método futureReservations.delete:

DELETE https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

Substitua:

  • PROJECT_ID: o ID do projeto em que sua solicitação de reserva adiantada no modo de calendário existe.

  • ZONE: a zona em que a solicitação está.

  • FUTURE_RESERVATION_NAME: o nome da sua solicitação.

A seguir