Modificar futuras solicitações de reserva

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

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

   Ir para Reservas

2. Clique na guia Reservas futuras .

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

   A página de detalhes da solicitação de reserva futura selecionada é aberta.

4. Se você quiser modificar a opção de exclusão automática, a descrição ou o prefixo do nome de uma reserva futura aprovada, execute um ou mais dos seguintes procedimentos:

   • Para modificar a opção de exclusão automática, na linha Hora de exclusão automática de reservas criadas automaticamente , clique em edit Editar e faça o seguinte:

     1. Especifique se deseja ativar, desativar ou modificar a opção de exclusão automática seguindo um destes procedimentos:

        • Para ativar a opção de exclusão automática ou alterar o horário 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: para Horário de exclusão automática , insira uma nova data e hora para excluir as reservas criadas automaticamente. A data e a hora devem ser posteriores ao horário de término do período de reserva. Se você deixar este campo vazio, as reservas criadas automaticamente serão excluídas dentro de duas horas após o horário de término do período de reserva.

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

     2. Clique em Enviar .

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

     1. Em Prefix , insira um novo prefixo de nome.

     2. Clique em Enviar .

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

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

     2. Clique em Enviar .

5. Clique em edit Editar ou edit Editar rascunho .

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

6. Para modificar um pedido de reserva futuro e enviá-lo paraGoogle Cloud para revisão ou salve o rascunho da solicitação, execute um ou mais dos seguintes procedimentos:

   • Em Prefix , insira um novo prefixo de nome para as reservas criadas automaticamente e provisionadas para esta solicitação de reserva futura.

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

   • Modifique a hora de início ou de término da sua solicitação de reserva futura. Certifique-se do seguinte:

     • A hora de início não pode ser posterior a um ano a partir da data e hora em que você envia uma solicitação de reserva futura para análise.

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

     • Especifique um período mínimo de reserva recomendado para aumentar a probabilidade de que Google Cloud aprova sua solicitação após enviá-la para revisão.

   • Na seção Tipo de compartilhamento , você pode selecionar Local ou Compartilhado . Se você selecionar Compartilhado , poderá adicionar ou remover projetos com os quais compartilhar a solicitação de reserva futura. Você pode incluir até 100 projetos.

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

   • Se estiver modificando uma reserva futura que não foi criada por meio de um modelo de instância, na seção Configuração da máquina , você poderá alterar 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 de disco das VMs reservadas.

   • Na seção Exclusão automática de reservas geradas automaticamente , você pode ativar ou desativar a exclusão automática de reservas criadas automaticamente para sua solicitação de reserva futura.

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

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

     • Para salvar suas alterações, clique em Salvar rascunho .

     • Para enviar o projeto de pedido de reserva futura paraGoogle Cloud para revisão, clique em Enviar .

   • Caso contrário, clique em Enviar .

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

gcloud

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

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

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

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

  • Para enviar o pedido de reserva futura para análise: SUBMITTED .

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

Substitua um ou mais dos seguintes espaços reservados ou remova-os junto com seus sinalizadores 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, siga um destes procedimentos:

  • Para excluir as reservas dentro de duas horas após o horário de término (padrão), inclua o sinalizador --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 término do período de reserva, inclua os sinalizadores --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 formatada como um carimbo de data/hora RFC 3339 .

  • Para excluir as reservas criadas automaticamente após um período específico após o horário de término do período de reserva, inclua os sinalizadores --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 e provisionadas para essa solicitação de reserva futura, inclua a sinalização --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 de GPU, siga um destes procedimentos:

  • Para alterar 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 adicionado às VMs reservadas. Certifique-se de que a GPU esteja disponível na zona onde a futura solicitação de reserva está localizada. Caso contrário, a modificação da solicitação falhará.

  • Para remover todas as GPUs anexadas a VMs N1 reservadas, substitua o sinalizador --accelerator pelo sinalizador --clear-accelerator .

• DESCRIPTION : Uma nova descrição para sua futura solicitação de reserva.

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

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

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

    • Caso contrário: scsi .

    Inclua o sinalizador --local-ssd para quantos discos SSD locais você deseja adicionar. Você pode especificar no máximo 24 discos SSD locais.

  • Para remover todos os discos SSD locais anexados às VMs reservadas, remova todos os sinalizadores --local-ssd e inclua o sinalizador --clear-local-ssd .

• MACHINE_TYPE : o novo tipo de máquina a ser usado para cada VM reservada. Se você alterar o tipo de máquina, especifique também um período de reserva mínimo recomendado para a nova série de máquinas. De outra forma, Google Cloud provavelmente recusará sua 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 criadas automaticamente e provisionadas para sua solicitação de reserva futura.

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

  • Para uma solicitação de reserva futura de projeto único: local . Para evitar erros, você também deve substituir o sinalizador --share-with pelo sinalizador --clear-share-settings .

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

• CONSUMER_PROJECT_IDS : uma lista separada por vírgulas de IDs de projetos com os quais você deseja compartilhar sua solicitação de reserva futura, por exemplo, project-1,project-2 . Você pode especificar até 100 projetos de consumo.

• START_TIME : o novo horário de início do período de reserva formatado como um carimbo de data/hora RFC 3339 . A hora de início não pode ser posterior a um ano a partir da data e hora em que você envia a solicitação de modificação para revisão. Para ter tempo suficiente para cancelar, excluir ou modificar opcionalmente uma reserva futura após ela ser aprovada e antes de entrar 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. Para aumentar a probabilidade de queGoogle Cloud aprova sua solicitação após o envio, especifique um período mínimo de reserva . Para especificar uma duração em vez de um horário de término, substitua o sinalizador --end-time pelo sinalizador --duration= END_DURATION . Substitua END_DURATION pela duração do período de reserva em segundos. Por exemplo, especifique 1209600 para 1.209.600 segundos (14 dias).

• TOTAL_COUNT : o novo número total de VMs que você deseja reservar para o período, configuração de VM e projeto(s) especificado(s) em sua solicitação de reserva futura. Se quiser aumentar a contagem total, certifique-se de ter cota suficiente para os recursos que está reservando. De outra forma, Google Cloud recusa sua solicitação de modificação.

Por exemplo, considere um rascunho de solicitação de reserva futura compartilhada chamada fr-03 e localizada na zona us-central1-a . Suponha que você queira modificar esta solicitação de reserva futura compartilhada fazendo as seguintes alterações:

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

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

• Reserve 100 VMs.

• Envie o pedido de reserva futura para Google Cloud para revisão.

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

DESCANSAR

Para modificar uma solicitação de reserva futura, faça uma solicitação PATCH ao 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 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.

• UPDATE_FIELDS : uma lista separada por vírgulas de campos a serem atualizados no corpo da solicitação. Você deve codificar cada vírgula como %2C . Se você especificar um campo no parâmetro de consulta updateMask e no corpo da solicitação, isso atualizará o valor do campo. Caso contrário, se você especificar o campo apenas no parâmetro de consulta updateMask , isso excluirá o campo.

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

  autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
  

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

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

  • Para enviar a solicitação de modificação para revisão: SUBMITTED .

Substitua um ou mais dos seguintes espaços reservados ou remova-os junto com seus campos correspondentes:

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS : se você definir esse campo como true , o Compute Engine excluirá automaticamente as reservas criadas automaticamente e provisionadas para sua solicitação de reserva futura. Por padrão, a exclusão ocorre dentro de duas horas após o horário de término do período de reserva. Para alterar 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 pela data e hora em que o Compute Engine exclui reservas. A data e a hora devem ser formatadas como um carimbo de data/hora RFC 3339 .

  • Para excluir as reservas criadas automaticamente após um período específico a partir do horário de início do período de reserva, defina 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 futura solicitação de reserva.

• NAME_PREFIX : um novo prefixo de nome para as reservas criadas automaticamente e provisionadas para sua solicitação de reserva futura.

• CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2 : os IDs dos projetos com os quais você deseja compartilhar sua futura solicitação de reserva. Os projetos devem estar na mesma organização que o projeto proprietário. Você pode especificar até 100 projetos de consumo.

• SHARE_TYPE : um novo tipo de compartilhamento para sua futura solicitação de reserva. Faça um dos seguintes:

  • Para especificar uma solicitação de reserva futura 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 consumidor no campo shareSettings.projects . Os projetos consumidores devem estar na mesma organização que o projeto proprietário. Você pode especificar até 100 projetos de consumo.

• Para alterar o número e o tipo de GPUs a serem anexadas à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 adicionado às VMs reservadas. Certifique-se de que a GPU esteja disponível na zona onde a futura solicitação de reserva 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 .

    Você pode especificar no máximo 24 discos SSD locais.

• MACHINE_TYPE : o novo tipo de máquina a ser usado para cada VM reservada. Se você alterar o tipo de máquina, certifique-se de especificar também um período mínimo de reserva recomendado . para a nova série de máquinas. De outra forma, Google Cloud é menos provável que 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ê deseja reservar para o período, configuração de VM e projeto(s) especificado(s) nesta solicitação de reserva futura. Se quiser aumentar a contagem total, certifique-se de ter cota suficiente para os recursos que está reservando. De outra forma, Google Cloud recusa sua 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 . A hora de início não pode ser posterior a um ano a partir da data e hora em que você envia a solicitação de modificação para revisão. Para ter tempo suficiente para cancelar, excluir ou modificar opcionalmente uma reserva futura após ela ser aprovada e antes de entrar 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. Para aumentar a probabilidade de queGoogle Cloud aprova sua solicitação após o envio, especifique um período mínimo de reserva . Para especificar uma duração em vez de um horário de término, substitua o campo endTime pelo campo duration :

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

Por exemplo, considere um rascunho de solicitação de reserva futura compartilhada chamada fr-03 e localizada na zona us-central1-a . Suponha que você queira modificar esta solicitação de reserva futura compartilhada fazendo as seguintes alterações:

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

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

• Reserve 100 VMs.

• Envie o pedido de reserva futura para Google Cloud para revisão.

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

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