Modificar solicitações de reserva adiantada


Neste documento, explicamos como modificar solicitações de reserva adiantada.

É possível modificar uma solicitação de reserva adiantada a qualquer momento antes do horário de início, desde que não tenha sido cancelada ou esteja pendente de aprovação. Modificar uma solicitação de reserva adiantada é útil quando é necessário alterar a capacidade, por exemplo, quando você quer aumentar o número de instâncias de máquina virtual (VM) reservadas ou mudar o período de reserva. Se você quiser modificar uma solicitação de reserva adiantada compartilhada, use o proprietário do projeto.

Para modificar uma reserva criada automaticamente após o término do período de reserva, consulte Modificar reservas.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da 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:

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

      gcloud init
    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.

        Install the Google Cloud CLI, then initialize it by running the following command:

        gcloud init

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

Funções exigidas

Para receber a permissão necessária para modificar solicitações de reserva adiantada, peça para o administrador conceder a você o papel do IAM de Administrador da reserva adiantada do Compute (roles/compute.futureReservationAdmin) do 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 compute.futureReservations.update que é a permissão necessária para modificar solicitações de reserva adiantada.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Propriedades modificáveis

Uma solicitação de reserva adiantada tem várias propriedades que definem a reserva, determinam o comportamento dela e especificam os recursos a serem reservados. É possível modificar essas propriedades, conforme descrito nas seções a seguir.

Após a criação

Após criar uma solicitação de reserva adiantada, não será possível modificar as seguintes propriedades:

  • O nome da solicitação de reserva adiantada.

  • O projeto em que a solicitação de reserva adiantada foi criada.

  • A zona em que a solicitação de reserva adiantada está localizada.

  • O modelo de instância a ser usado e as propriedades da VM especificadas no modelo de instância.

Para modificar qualquer uma dessas propriedades antes que uma solicitação de reserva adiantada entre no horário de bloqueio, crie uma nova solicitação.

Antes do envio

Antes de enviar uma solicitação de reserva adiantada ao Google Cloud para análise, ou depois de enviar um pedido de reserva adiantada para análise e a solicitação for recusada, será possível modificar as seguintes propriedades:

  • Opção de exclusão automática

  • Descrição

  • GPUs e tipo de GPU

  • Discos SSD locais e tipo de interface dos discos

  • Série e tipo de máquina

  • Plataforma mínima de CPU

  • Prefixo de nome

  • Configurações de compartilhamento

  • Horário de início e término do período de reserva

  • Contagem total (número de VMs)

A modificação do estado de um rascunho de solicitação de reserva adiantada é imediata, e não há limites para o número de vezes que se pode fazer isso. Se você modificar uma solicitação de reserva adiantada recusada (DECLINED), só será possível modificar a solicitação se enviá-la novamente para avaliação.

Após a aprovação

Depois que o Google Cloud aprova uma reserva adiantada, é possível modificá-la antes que ela atinja um status de aquisição de provisionamento (PROVISIONING). Especificamente, é possível modificar as seguintes propriedades:

  • Ao modificar a reserva adiantada, a qualquer momento:

    • Opção de exclusão automática

    • Descrição

    • Prefixo de nome

  • Ao enviar uma solicitação de modificação no mínimo 72 horas antes do horário de início:

    • GPUs e tipo de GPU*

    • Discos SSD locais e tipo de interface dos discos*

    • Série e tipo de máquina*

    • Plataforma mínima de CPU*

    • Configurações de compartilhamento

    • Horário de início e término do período de reserva

    • Contagem total (número de VMs)*

* Se você solicitar a alteração de quaisquer propriedades de VM, ou aumentar ou diminuir significativamente a contagem total, no período de 14 dias antes do horário de início da reserva adiantada, é provável que o Google Cloud rejeite a solicitação.

Modificar solicitações de reserva adiantadas

Antes de modificar uma solicitação de reserva adiantada, consulte as propriedades que podem ser modificadas, caso ainda não tenha feito isso.

Se você quiser modificar uma solicitação de reserva adiantada de projeto único criada com um modelo de instância em uma solicitação de reserva adiantada compartilhada, não será possível usar o mesmo modelo para criar VMs que possam efetivar as reservas criadas automaticamente fora do projeto que criou a solicitação de reserva adiantada compartilhada. Para os projetos que compartilham a reserva adiantada, crie modelos semelhantes nesses projetos ou crie VMs especificando diretamente as propriedades.

Para modificar uma solicitação de reserva adiantada, selecione uma das seguintes opções:

Console

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

    Acessar "Reservas"

  2. Clique na guia Reservas adiantadas.

  3. Na coluna Nome, clique no nome da solicitação de reserva adiantada que você quer modificar.

    A página de detalhes da solicitação de reserva adiantada selecionada será aberta.

  4. Se você quiser modificar a opção de exclusão automática, a descrição ou ot prefixo do nome de uma reserva adiantada aprovada, siga um ou mais destes procedimentos:

    • Para modificar a opção de exclusão automática, na linha Horário de exclusão automática de reservas criadas automaticamente, clique em Editar e siga estas etapas:

      1. Especifique se quer ativar, desativar ou modificar a opção de exclusão automática, realizando uma das ações a seguir:

        • Para ativar a opção de exclusão automática ou alterar a hora em que O Compute Engine exclui automaticamente as reservas criadas automaticamente, faça o seguinte:

          1. Clique no botão Ativar exclusão automática para a posição ativada.

          2. Opcional: em Horário da exclusão automática, digite uma nova data e hora para excluir as reservas criadas automaticamente. A data e hora devem ser posteriores ao horário de término do período de reserva. Se você deixar esse campo em branco, as reservas criadas automaticamente serão excluídas em até duas horas após o horário de término do período de reserva.

        • Caso contrário, clique no botão de alternar Ativar exclusão automática para a posição desativada.

      2. Clique em Enviar.

    • Para modificar o prefixo do nome, na linha Prefixo, clique em Editar e faça o seguinte:

      1. Em Prefixo, digite um novo prefixo de nome.

      2. Clique em Enviar.

    • Para modificar a descrição, na linha Descrição, clique em Editar e faça o seguinte:

      1. Em Descrição, insira uma nova descrição.

      2. Clique em Enviar.

  5. Clique em Editar ou Editar rascunho.

    A página para editar a solicitação de reserva adiantada selecionada será aberta.

  6. Para modificar uma solicitação de reserva adiantada e enviá-la ao Google Cloud para análise ou salvar o rascunho, siga um ou mais dos seguintes procedimentos:

    • Em Prefixo, insira um novo prefixo de nome para as reservas criadas automaticamente provisionadas para essa solicitação de reserva adiantada.

    • Em Descrição, insira uma nova descrição.

    • Modifique o Horário de início ou o Horário de término do seu pedido de reserva adiantada. Certifique-se disto:

      • O horário de início não pode ser posterior a um ano da data e hora em que foi enviada uma solicitação de reserva adiantada para análise.

      • Especifique um valor recomendado para o horário de início a fim de garantir que você tenha tempo suficiente antes que sua reserva adiantada entre no horário de bloqueio.

      • Especifique um período mínimo de reserva recomendado para aumentar a probabilidade do Google Cloud aprovar a solicitação depois de enviá-la para análise.

    • Na seção Tipo de compartilhamento, é possível selecionar Local ou Compartilhado. Se você selecionar Compartilhado, será possível adicionar ou remover projetos para compartilhar a solicitação de reserva adiantada. É possível incluir até 100 projetos.

    • Em Número de instâncias de VM, insira a contagem total de VMs que você quer reservar.

    • Se estiver modificando uma reserva adiantada que não foi criada com um modelo de instância, na seção Configuração da máquina, é possível mudar o seguinte:

      • A série e o tipo de máquina usados nas VMs reservadas.

      • As GPUs a serem anexadas às VMs reservadas.

      • Os discos SSD locais e o tipo de interface do disco das VMs reservadas.

    • Na seção Exclusão automática de reservas geradas automaticamente, é possível ativar ou desativar a exclusão automática de reservas criadas automaticamente para seu pedido de reserva adiantada.

  7. Dependendo do status de aquisição da solicitação de reserva adiantada que você está modificando, siga um destes procedimentos:

    • Se estiver modificando um rascunho de solicitação de reserva adiantada, siga um destes procedimentos:

      • Para salvar as mudanças, clique em Salvar rascunho.

      • Para enviar o rascunho da solicitação de reserva adiantada ao Google Cloud para análise, clique em Enviar.

    • Caso contrário, clique em Enviar.

Se você enviar uma solicitação de modificação, a página Reservas é aberta. Caso contrário, a página de detalhes da reserva adiantada é aberta.

gcloud

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

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Substitua:

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

  • PLANNING_STATUS: o status de planejamento da solicitação de reserva adiantada. Especifique um dos seguintes valores:

    • Para modificar um rascunho de solicitação de reserva adiantada sem enviá-lo para análise: DRAFT.

    • Para enviar a solicitação de reserva adiantada para análise: SUBMITTED.

  • ZONE: a zona em que a solicitação de reserva adiantada está localizada.

Substitua um ou mais dos marcadores de posição a seguir ou remova-os com as flags correspondentes:

  • Para permitir que o Compute Engine exclua automaticamente as reservas criadas automaticamente após o horário de término do período de reserva, faça um dos seguintes procedimentos:

    • Para excluir as reservas em até duas horas após o horário de término (padrão), inclua a flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      
    • Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, inclua as flags --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

      Substitua AUTO_CREATED_RESERVATIONS_DELETE_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339.

    • Para excluir as reservas criadas automaticamente após uma duração específica e após o horário de término do período de reserva, inclua os flags --auto-delete-auto-created-reservations e --auto-created-reservations-duration.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

      Substitua DURATION_BEFORE_DELETE por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.

  • Para impedir que o Compute Engine exclua automaticamente as reservas criadas automaticamente provisionadas para essa solicitação de reserva adiantada, inclua a flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    
  • Para adicionar ou remover GPUs anexadas a VMs N1 reservadas ou atualizar o tipo da GPU, siga um dos procedimentos:

    • Para mudar o número e o tipo de GPUs, substitua o seguinte:

      • NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.

      • ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas. Verifique se a GPU está disponível na zona em que a solicitação de reserva adiantada está localizada. Caso contrário, a modificação da solicitação falhará.

    • Para remover todas as GPUs anexadas a VMs N1 reservadas, substitua a flag --accelerator pela --clear-accelerator.

  • DESCRIPTION: uma nova descrição para o pedido de reserva adiantada.

  • Para adicionar ou remover discos SSD locais das VMs reservadas ou editar o tipo de interface do disco SSD local, siga um dos procedimentos:

    • Para adicionar discos SSD locais ou editar o tipo de interface do disco, substitua INTERFACE por um dos seguintes valores:

      Inclua a flag --local-ssd para todas as unidades de SSD locais que você quer adicionar. É possível especificar no máximo 24 discos SSD locais.

    • Para remover todos os discos SSD locais anexados às VMs reservadas, remova todas as flags --local-ssd e inclua a --clear-local-ssd.

  • MACHINE_TYPE: o novo tipo de máquina a ser usado em cada VM reservada. Se mudar o tipo de máquina, especifique também um período mínimo de reserva recomendado para a nova série de máquinas. Caso contrário, é provável que o Google Cloud recuse a solicitação de modificação.

  • MINIMUM_CPU_PLATFORM: uma nova plataforma de CPU mínima a ser usada para cada VM reservada.

  • NAME_PREFIX: um novo prefixo de nome para as reservas provisionadas criadas automaticamente para seu pedido de reserva adiantada.

  • SHARE_SETTING: um novo tipo de compartilhamento para a solicitação de reserva adiantada. Especifique um dos seguintes valores:

    • Para uma solicitação de reserva adiantada de projeto único: local. Para evitar erros, também é necessário substituir a flag --share-with pela --clear-share-settings.

    • Para uma solicitação de reserva futura compartilhada: projects. Para evitar erros, você também deve especificar pelo menos um projeto de consumidor na flag --share-with.

  • CONSUMER_PROJECT_IDS: uma lista separada por vírgulas de IDs de projetos com os quais você quer compartilhar seu pedido de reserva adiantada, por exemplo, project-1,project-2. É possível especificar até 100 projetos do consumidor.

  • START_TIME: o novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339. O horário de início não pode ser posterior a um ano da data e do horário em que você enviar a solicitação de modificação para análise. Para ter tempo suficiente para poder cancelar, excluir ou modificar uma reserva adiantada depois que ela for aprovada e antes que ela entre no horário de bloqueio, especifique um horário de início recomendado.

  • END_TIME: o novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Como alternativa, substitua a flag --end-time pela flag --duration=END_DURATION. Substitua END_DURATION pela duração do período de reserva em segundos. Para aumentar a probabilidade de o Google Cloud aprovar uma solicitação de reserva adiantada depois de enviá-la para análise, especifique um período de reserva recomendado.

    .
  • TOTAL_COUNT: o novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados na solicitação de reserva adiantada. Se quiser aumentar a contagem total de armazenamento, certifique-se de ter cota suficiente para os recursos que estiver reservando. Caso contrário, o Google Cloud recusará a solicitação de modificação.

Por exemplo, pense em uma solicitação de reserva adiantada compartilhada com o nome de fr-03 e localizada na zona us-central1-a. Suponha que você queira modificar essa solicitação de reserva adiantada compartilhada fazendo as seguintes alterações:

  • Converta a solicitação em uma solicitação de reserva adiantada de projeto único.

  • Desativar a opção de exclusão automática.

  • Reservar 100 VMs.

  • Envie a solicitação de reserva adiantada ao Google Cloud para análise.

Para modificar fr-03, execute o seguinte comando:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

Para cancelar uma solicitação de reserva adiantada, faça uma solicitação PATCH para o método beta.futureReservations.update.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

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.

  • UPDATE_FIELDS: uma lista separada por vírgulas de campos para atualizar no corpo da solicitação. Codifique cada vírgula como %2C. Se você especificar um campo no parâmetro de consulta updateMask e no corpo da solicitação, o valor do campo será atualizado. Caso contrário, se você especificar o campo apenas no parâmetro de consulta updateMask, ele será excluído.

    Por exemplo, para atualizar os campos autoDeleteAutoCreatedReservations, totalCount e endTime na sua solicitação de reserva adiantada, especifique o seguinte:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • PLANNING_STATUS: o status de planejamento da solicitação de reserva adiantada. Especifique um dos seguintes valores:

    • Para modificar um rascunho de solicitação de reserva adiantada sem enviá-lo para análise: DRAFT.

    • Para enviar a solicitação de modificação para análise: SUBMITTED.

Substitua um ou mais marcadores de posição a seguir ou remova-os com os campos correspondentes:

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se você definir esse campo como true, o Compute Engine exclui automaticamente as reservas criadas automaticamente provisionadas para sua solicitação de reserva adiantada. Por padrão, a exclusão é feita em até duas horas após o horário de término do período de reserva. Para mudar isso, siga um destes procedimentos:

    • Para excluir as reservas criadas automaticamente em um horário específico após o horário de término do período de reserva, defina autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      Substitua DELETE_TIME por uma data e hora em que o Compute Engine exclui as reservas. A data e a hora precisam ser formatadas como um carimbo de data/hora RFC 3339.

    • Para excluir as reservas criadas automaticamente após uma duração específica a partir do horário de início do período de reserva, defina o autoDeleteAutoCreatedReservations como true e especifique o campo autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      Substitua DURATION_BEFORE_DELETE por uma duração em segundos. Por exemplo, especifique 604800 para 604.800 segundos (7 dias).

  • DESCRIPTION: uma nova descrição para a solicitação de reserva adiantada.

  • NAME_PREFIX: um novo prefixo de nome para as reservas provisionadas criadas automaticamente para seu pedido de reserva adiantada.

  • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: os IDs dos projetos com quem você quer compartilhar a solicitação de reserva adiantada. Os projetos precisam estar na mesma organização do projeto do proprietário. É possível especificar até 100 projetos do consumidor.

  • SHARE_TYPE: um novo tipo de compartilhamento para sua solicitação de reserva adiantada. Escolha uma destas opções:

    • Para especificar uma solicitação de reserva adiantada de projeto único, faça o seguinte:

      • Especifique LOCAL.

      • Remova o campo shareSettings.projects.

    • Para especificar uma solicitação de reserva futura compartilhada, faça o seguinte:

      • Especifique SPECIFIC_PROJECTS.

      • Especifique pelo menos um projeto do consumidor no campo shareSettings.projects. Os projetos do consumidor precisam estar na mesma organização do projeto do proprietário. É possível especificar até 100 projetos do consumidor.

  • Para mudar o número e o tipo de GPUs a serem anexados às VMs N1 reservadas, substitua o seguinte:

    • NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.

    • ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas. Verifique se a GPU está disponível na zona em que a solicitação de reserva adiantada está localizada. Caso contrário, a modificação da solicitação falhará.

  • INTERFACE_1 e INTERFACE_2: o tipo de interface de disco para os discos SSD locais anexados a cada VM reservada. Especifique um dos seguintes valores:

    • Se a imagem do disco de inicialização tiver drivers NVMe otimizados: NVME.

    • Caso contrário: SCSI.

      É possível especificar no máximo 24 discos SSD locais.

  • MACHINE_TYPE: o novo tipo de máquina a ser usado em cada VM reservada. Se mudar o tipo de máquina, especifique também um período mínimo de reserva recomendado para a nova série de máquinas. Caso contrário, é menos provável que o Google Cloud aprove sua solicitação de modificação.

  • MINIMUM_CPU_PLATFORM: uma nova plataforma de CPU mínima a ser usada para cada VM reservada.

  • TOTAL_COUNT: o novo número total de VMs que você quer reservar para o período, a configuração da VM e os projetos especificados nesta solicitação de reserva adiantada. Se quiser aumentar a contagem total de armazenamento, certifique-se de ter cota suficiente para os recursos que estiver reservando. Caso contrário, o Google Cloud recusará a solicitação de modificação.

  • START_TIME: o novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339. O horário de início não pode ser posterior a um ano da data e do horário em que você enviar a solicitação de modificação para análise. Para ter tempo suficiente para poder cancelar, excluir ou modificar uma reserva adiantada depois que ela for aprovada e antes que ela entre no horário de bloqueio, especifique um horário de início recomendado.

  • END_TIME: o novo horário de término do período de reserva formatado como um carimbo de data/hora RFC 3339. O período de reserva precisa durar pelo menos 24 horas. Como alternativa, é possível substituir o campo endTime pelo campo duration para especificar uma duração específica a partir do horário de início do período de reserva:

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus
    
    {
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS",
      "timeWindow": {
        "duration": {
          "seconds": "END_DURATION"
        }
      }
    }
    

    Substitua END_DURATION por uma duração em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias). Para aumentar a probabilidade de o Google Cloud aprovar uma solicitação de reserva adiante depois de enviá-la para análise, especifique um período de reserva recomendado.

    .

Por exemplo, pense em uma solicitação de reserva adiantada compartilhada com o nome de fr-03 e localizada na zona us-central1-a. Suponha que você queira modificar essa solicitação de reserva adiantada compartilhada fazendo as seguintes alterações:

  • Converta a solicitação em uma solicitação de reserva adiantada de projeto único.

  • Desativar a opção de exclusão automática.

  • Reservar 100 VMs.

  • Envie a solicitação de reserva adiantada ao Google Cloud para análise.

Para modificar fr-03, faça uma solicitação PATCH da seguinte maneira:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": false,
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Depois de modificar uma solicitação de reserva adiantada, é possível monitorar a aquisição ou atualizar o status de visualização dos detalhes da solicitação de reserva adiantada.

Alterar outras propriedades em uma solicitação de reserva adiantada

Para mudar propriedades que não podem ser modificadas depois de criar uma solicitação de reserva adiantada, e antes que a solicitação seja aprovada e entre no horário de bloqueio, faça o seguinte:

  1. Para impedir que a solicitação de reserva adiantada restrinja o tipo de solicitações de reserva adiantadas que você pode criar no projeto atual ou nos projetos com os quais a solicitação de reserva adiantada é compartilhada, exclua a solicitação de reserva adiantada.

  2. Crie um novo projeto único ou pedido de reserva adiantada compartilhado com as atualizações desejadas.

Resolver problemas

Se encontrar erros ao modificar uma solicitação de reserva adiantada, consulte como solucionar problemas de solicitações de reserva adiantada.

Se ainda encontrar problemas após a solução de problemas, entre em contato com o representante da conta ou com o suporte do Google Cloud.

A seguir