Cancele ou elimine pedidos de reserva futuros

---

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Este documento descreve como cancelar ou eliminar pedidos de reserva futuros.

Antes de um pedido de reserva futuro atingir o respetivo tempo de bloqueio, pode impedir que o Compute Engine aprovisione os recursos pedidos através de uma das seguintes ações:

• Cancelar o pedido de reserva futura. Isto é útil para manter o pedido cancelado como referência quando criar novos pedidos. No entanto, um pedido de reserva futuro cancelado impede-o de criar novos pedidos com propriedades que correspondam ao pedido cancelado no seu projeto ou nos projetos com os quais o pedido é partilhado, até o eliminar. Para mais informações, consulte Restrições na criação.

• Eliminar o pedido de reserva futuro. Isto é útil quando já não precisa do pedido. A eliminação de um pedido de reserva futuro elimina-o permanentemente e remove quaisquer restrições à criação de novos pedidos.

Depois de uma reserva futura concluída atingir o fim do respetivo período de reserva, pode eliminá-la para remover quaisquer restrições à criação de novos pedidos. No entanto, a eliminação de uma reserva futura realizada não elimina as reservas criadas automaticamente. Para eliminar uma reserva criada automaticamente após o respetivo período de reserva terminar, consulte o artigo Elimine reservas.

Antes de começar

• Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se 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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

     gcloud init

     Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

     Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.
  2. Set a default region and zone.

  REST

  Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

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

  gcloud init

  Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

  Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.

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

Funções necessárias

Para receber as autorizações de que precisa para cancelar ou eliminar pedidos de reserva futuros, peça ao seu administrador para lhe conceder a função Administrador de reservas futuras do Compute (roles/compute.futureReservationAdmin) do IAM no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para cancelar ou eliminar pedidos de reserva futuros. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para cancelar ou eliminar pedidos de reserva futuros:

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

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Cancele pedidos de reserva futuros

Só pode cancelar um pedido de reserva futuro nos seguintes casos:

• O pedido está pendente de aprovação ou foi recusado.

• O pedido foi aprovado, mas o respetivo estado ainda não foi alterado para PROCURING.

Depois de cancelar um pedido de reserva futuro, só pode ver os respetivos detalhes ou eliminá-lo.

Importante: enquanto existir um pedido cancelado, este impede a criação de novos pedidos com propriedades que correspondam aos pedidos cancelados no seu projeto ou em qualquer um dos projetos com os quais o pedido cancelado é partilhado. Para criar novos pedidos com propriedades que correspondam ao pedido cancelado, elimine o pedido cancelado antes de criar novos.

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

gcloud

Para cancelar um pedido de reserva futuro, 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 um pedido de reserva futuro existente.

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

REST

Para cancelar um pedido de reserva futuro, faça um pedido POST ao beta.futureReservations.cancel method.

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 se encontra o futuro pedido de reserva.

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

• FUTURE_RESERVATION_NAME: o nome do pedido de reserva futuro.

Elimine pedidos de reserva futuros

Só pode eliminar um pedido de reserva futuro nos seguintes casos:

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

• O pedido foi cumprido e o respetivo período de reserva terminou.

Para eliminar um pedido de reserva futuro pendente de aprovação, tem de cancelar o pedido antes de o eliminar.

A eliminação de uma reserva futura concluída não elimina as reservas criadas automaticamente. Para eliminar uma reserva criada automaticamente após o respetivo período de reserva terminar, consulte o artigo Elimine reservas.

Para eliminar vários pedidos de reserva futuros em simultâneo, use a Google Cloud consola. Caso contrário, para eliminar um único pedido de reserva futuro, selecione qualquer uma das seguintes opções:

Consola

1. Na Google Cloud consola, aceda à página Reservas.

   Aceda a Reservas

2. Clique no separador Reservas futuras.

3. Selecione cada pedido de reserva futuro que quer eliminar.

4. Clique em Eliminar reserva.

5. Para confirmar, clique em Eliminar.

   A eliminação de um pedido de reserva futuro pode demorar até um minuto a ser concluída.

gcloud

Para eliminar um pedido de reserva futuro, 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 um pedido de reserva futuro existente.

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

REST

Para eliminar um pedido de reserva futuro, faça um DELETEpedido ao 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 se encontra o futuro pedido de reserva.

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

• FUTURE_RESERVATION_NAME: o nome de um pedido de reserva futuro existente.

O que se segue?

• Saiba como ver pedidos de reserva futuros.