Modifique reservas

Este documento explica como modificar as reservas. Para modificar reservas associadas a compromissos, consulte o artigo Substitua reservas associadas a compromissos.

Modificar uma reserva quando, por exemplo, as suas necessidades de capacidade mudam ou quer alterar as cargas de trabalho que podem consumir uma reserva.

Limitações

Antes de modificar uma reserva, considere o seguinte:

  • Só pode modificar uma reserva partilhada no mesmo projeto onde a criou.

  • Só pode modificar uma reserva criada automaticamente depois de:

    • Para uma reserva futura criada no AI Hypercomputer, só pode modificar a reserva após a hora de início.

    • Para uma reserva futura criada no Compute Engine, só pode modificar a reserva após a respetiva hora de fim.

  • Pode modificar uma reserva criada automaticamente para uma reserva futura no IA Hypercomputer apenas para permitir ou não permitir que os trabalhos do Vertex AI a consumam.

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 Trusted Cloud by S3NS 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init
    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 e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

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

Funções necessárias

Para receber as autorizações de que precisa para modificar as reservas, peça ao seu administrador que lhe conceda a função de administrador de computação (roles/compute.admin) 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 modificar reservas. 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 modificar reservas:

  • Para modificar a opção de eliminação automática numa reserva, os projetos de consumo numa reserva partilhada ou se as tarefas do Vertex AI podem consumir uma reserva de instâncias com GPUs anexadas: compute.reservations.update no projeto
  • Para modificar o número de instâncias numa reserva: compute.reservations.resize no projeto

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

Modifique reservas

Com base nas propriedades que quer modificar numa reserva, use um dos seguintes métodos:

Para alterar quaisquer propriedades que não sejam mencionadas nesta lista, tem de criar uma nova reserva. Para ver instruções, consulte a secção Altere outras propriedades numa reserva neste documento.

Modifique a eliminação automática de uma reserva

Pode modificar o momento em que o Compute Engine elimina automaticamente uma reserva existente através de uma das seguintes ações:

Para modificar a eliminação automática de uma reserva, selecione uma das seguintes opções:

Consola

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

    Aceda a Reservas

  2. No separador Reservas a pedido (predefinição), na coluna Nome, clique no nome da reserva que quer modificar.

    É apresentada a página de detalhes da reserva.

  3. Na linha Tempo de eliminação automática, clique em Editar tempo de eliminação automática.

  4. No painel Atualizar reserva, efetue uma das seguintes ações:

    • Para eliminar a reserva numa data e hora específicas, faça o seguinte:

      1. Se a opção de eliminação automática ainda não estiver ativada, clique no botão Ativar eliminação automática para a posição ativada.

      2. No campo Hora de eliminação automática, introduza uma data e uma hora em que o Compute Engine elimina automaticamente a reserva.

    • Caso contrário, clique no botão Ativar eliminação automática para o colocar na posição desativada.

  5. Clique em Enviar.

    A modificação da reserva pode demorar alguns segundos a ser concluída.

gcloud

Quando ativa a opção de eliminação automática numa reserva, pode especificar uma data e uma hora em que a reserva deve ser eliminada ou especificar uma duração após a qual a reserva deve ser eliminada.

Para ativar a opção de eliminação automática ou alterar o momento em que a reserva deve ser eliminada, faça uma das seguintes ações:

  • Para eliminar a reserva numa data e hora específicas, use o comando gcloud beta compute reservations update com a flag --delete-at-time.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --zone=ZONE

    Substitua o seguinte:

    • RESERVATION_NAME: o nome de uma reserva existente.

    • DELETE_AT_TIME: uma data e uma hora formatadas como uma data/hora RFC 3339.

    • ZONE: a zona onde a reserva está localizada.

  • Para eliminar a reserva após uma duração específica, use o comando gcloud beta compute reservations update com a flag --delete-after-duration.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --zone=ZONE

    Substitua o seguinte:

    • RESERVATION_NAME: o nome de uma reserva existente.

    • DELETE_AFTER_DURATION: uma duração em dias, horas, minutos ou segundos antes de a reserva ser eliminada automaticamente. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.

    • ZONE: a zona onde a reserva está localizada.

Para desativar a opção de eliminação automática, use o comando gcloud beta compute reservations update com a flag --disable-auto-delete.

gcloud beta compute reservations update RESERVATION_NAME \
    --disable-auto-delete \
    --zone=ZONE

Substitua o seguinte:

  • RESERVATION_NAME: o nome de uma reserva existente.

  • ZONE: a zona onde a reserva está localizada.

REST

Quando ativa a opção de eliminação automática numa reserva, pode especificar uma data e uma hora em que a reserva deve ser eliminada ou especificar uma duração após a qual a reserva deve ser eliminada.

Para ativar a opção de eliminação automática ou alterar o momento em que a reserva deve ser eliminada, faça uma das seguintes ações:

  • Para eliminar a reserva numa data e hora específicas, faça um PATCH pedido ao métodobeta.reservations.update. No URL do pedido, inclua o parâmetro de consulta paths definido como deleteAtTime.

    PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime

{
  "name": "RESERVATION_NAME",
  "deleteAtTime": "DELETE_AT_TIME"
}

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde se encontra a reserva.

    • ZONE: a zona onde a reserva está localizada.

    • RESERVATION_NAME: o nome de uma reserva existente.

    • DELETE_AT_TIME: uma data e uma hora formatadas como uma data/hora RFC 3339.

  • Para eliminar a reserva após uma duração específica, faça um PATCH pedido ao método.beta.reservations.update No URL do pedido, inclua o parâmetro de consulta paths definido como deleteAfterDuration.seconds.

    PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds

{
  "name": "RESERVATION_NAME",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  }
}

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde se encontra a reserva.

    • ZONE: a zona onde a reserva está localizada.

    • RESERVATION_NAME: o nome de uma reserva existente.

    • DELETE_AFTER_DURATION: uma duração em segundos antes de a reserva ser eliminada automaticamente. Por exemplo, especifique 86400 para 86 400 segundos (1 dia).

Para desativar a opção de eliminação automática, faça um pedido PATCH ao método.beta.reservations.update No pedido, especifique o parâmetro de consulta paths=deleteAtTime&paths=deleteAfterDuration e omita o corpo do pedido.

PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde se encontra a reserva.

  • ZONE: a zona onde a reserva está localizada.

  • RESERVATION_NAME: o nome de uma reserva existente.

Modifique os projetos do consumidor numa reserva partilhada

Para evitar erros quando modifica os projetos de consumidor de uma reserva partilhada, considere o seguinte:

  • Remoção de projetos: pode impedir que os projetos de consumidor consumam uma reserva partilhada apenas se nenhuma instância de computação nesses projetos consumir a reserva. Para impedir que as instâncias consumam uma reserva, pare ou elimine as instâncias.

  • Adição de projetos: pode permitir que os projetos de consumidor consumam uma reserva partilhada apenas se estes projetos estiverem na mesma organização que o projeto proprietário. Para migrar um projeto para a organização do projeto proprietário, consulte o artigo Migrar projetos entre recursos da organização na documentação do Resource Manager.

Depois de modificar os projetos de consumidor de uma reserva partilhada, o consumo da reserva pode mudar. Por exemplo, se configurou a reserva para permitir que todas as instâncias correspondentes a consumam (a configuração predefinida), todos os projetos consumidores adicionados recentemente podem começar imediatamente a consumir a reserva. Para saber mais sobre que projetos de reservas correspondentes são consumidos primeiro, consulte a secção Ordem de consumo de reservas.

Para modificar os projetos de consumidor que podem consumir uma reserva partilhada, selecione uma das seguintes opções:

Consola

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

    Aceda a Reservas

  2. No separador Reservas a pedido (predefinição), na coluna Nome, clique no nome da reserva que quer descrever.

    É apresentada a página de detalhes da reserva.

  3. Clique em Editar.

  4. Na secção Projetos selecionados, faça uma das seguintes ações:

    • Para parar de partilhar a reserva com um projeto de consumidor específico, clique em Eliminar.

    • Para começar a partilhar a reserva com um ou mais projetos específicos, faça o seguinte:

      1. Clique em Adicionar projetos.

      2. Selecione a caixa de verificação de cada projeto da organização do projeto proprietário com o qual quer partilhar a reserva. Pode partilhar uma reserva partilhada com até 100 projetos de consumidor.

      3. Clique em Selecionar.

  5. Para confirmar as alterações, clique em Guardar.

    A modificação da reserva pode demorar alguns segundos a ser concluída.

gcloud

Quando modifica os projetos de consumidor de uma reserva partilhada, tem de especificar uma lista separada por vírgulas dos IDs dos projetos que quer permitir, ou deixar de permitir, que consumam a reserva partilhada. Estes projetos têm de estar na mesma organização que o projeto proprietário. Não especifique o projeto proprietário na lista. Por predefinição, já é permitido consumir a reserva partilhada.

Para modificar os projetos de consumidor de uma reserva partilhada, faça uma das seguintes ações:

  • Para permitir que um ou mais projetos consumam uma reserva partilhada, use o comando gcloud compute reservations update com a flag --add-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Substitua o seguinte:

    • RESERVATION_NAME: o nome de uma reserva partilhada existente.

    • CONSUMER_PROJECT_IDS: uma lista separada por vírgulas dos IDs dos projetos com os quais partilhar a reserva, por exemplo, project-1,project-2. Pode partilhar uma reserva partilhada com até 100 projetos de consumidor.

    • ZONE: a zona onde a reserva partilhada está localizada.

  • Para impedir que um ou mais projetos consumam uma reserva partilhada, use o comando gcloud compute reservations update com a flag --remove-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Substitua o seguinte:

    • RESERVATION_NAME: o nome de uma reserva partilhada existente.

    • CONSUMER_PROJECT_IDS: uma lista separada por vírgulas dos IDs dos projetos com os quais quer deixar de partilhar a reserva, por exemplo, project-1,project-2.

    • ZONE: a zona onde a reserva partilhada está localizada.

  • Para substituir a lista de projetos que podem consumir uma reserva partilhada, use o comando gcloud beta compute reservations update com a flag --share-with.

    gcloud beta compute reservations update RESERVATION_NAME \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Substitua o seguinte:

    • RESERVATION_NAME: o nome de uma reserva partilhada existente.

    • ZONE: a zona onde a reserva partilhada está localizada.

    • CONSUMER_PROJECT_IDS: uma lista separada por vírgulas dos IDs dos projetos com os quais partilhar a reserva, por exemplo, project-1,project-2. Pode partilhar uma reserva partilhada com até 100 projetos de consumidor.

REST

Quando modifica os projetos de consumidor de uma reserva partilhada, tem de especificar os IDs dos projetos que quer permitir ou deixar de permitir que consumam a reserva partilhada. Estes projetos têm de estar na mesma organização que o projeto proprietário. Não especifique o projeto proprietário. Por predefinição, já é permitido consumir a reserva partilhada.

Para modificar os projetos de consumidor de uma reserva partilhada, faça uma das seguintes ações:

  • Para permitir que um ou mais projetos consumam uma reserva partilhada, faça um pedido PATCH ao método reservations.update. No URL do pedido, inclua o parâmetro de consulta paths=shareSettings.projectMap.PROJECT_ID para cada projeto com o qual quer partilhar a reserva.

    Por exemplo, para permitir que dois projetos consumam uma reserva partilhada, faça um pedido PATCH da seguinte forma. Pode partilhar uma reserva partilhada com até 100 projetos de consumidor.

    PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
}

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto proprietário, que é o projeto usado para criar a reserva partilhada.

    • ZONE: a zona onde a reserva partilhada está localizada.

    • RESERVATION_NAME: o nome de uma reserva partilhada existente.

    • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: os IDs de dois projetos com os quais quer partilhar a reserva.

  • Para deixar de permitir que um ou mais projetos consumam uma reserva partilhada, faça um pedido PATCH ao método reservations.update. No URL do pedido, inclua o parâmetro de consulta paths=shareSettings.projectMap.PROJECT_ID para cada projeto com o qual quer deixar de partilhar a reserva. Além disso, tem de omitir o campo shareSetting do corpo do pedido.

    Por exemplo, para deixar de permitir que dois projetos consumam uma reserva partilhada, faça um pedido PATCH da seguinte forma:

    PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2

{
  "name": "RESERVATION_NAME"
}

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto proprietário, que é o projeto usado para criar a reserva partilhada.

    • ZONE: a zona onde a reserva partilhada está localizada.

    • RESERVATION_NAME: o nome de uma reserva partilhada existente.

    • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: os IDs de dois projetos com os quais quer parar de partilhar a reserva.

Modifique o número de instâncias reservadas numa reserva

Pode aumentar ou diminuir o número de instâncias de computação reservadas numa reserva. No entanto, antes de modificar o número de instâncias, considere o seguinte para evitar erros:

  • Para aumentar o número de instâncias em qualquer reserva, certifique-se de que:

  • Para diminuir o número de instâncias numa reserva específica, certifique-se de que o número de instâncias que consomem a reserva não excede o novo número inferior. Se o fizer, efetue um dos seguintes procedimentos com as instâncias que excedem o novo número:

    • Elimine instâncias

    • Parar ou suspender as instâncias

Para modificar o número de instâncias reservadas numa reserva, selecione uma das seguintes opções:

Consola

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

    Aceda a Reservas

  2. No separador Reservas a pedido (predefinição), na coluna Nome, clique no nome da reserva que quer modificar.

    É apresentada a página de detalhes da reserva.

  3. Clique em Editar.

  4. No campo Número de instâncias de VM, introduza o número atualizado de instâncias a reservar.

  5. Para confirmar, clique em Guardar.

    A modificação da reserva pode demorar alguns segundos a ser concluída.

gcloud

Para modificar o número de instâncias reservadas numa reserva, use o comando gcloud compute reservations update.

gcloud compute reservations update RESERVATION_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Substitua o seguinte:

  • RESERVATION_NAME: o nome de uma reserva existente.

  • NUMBER_OF_VMS: o novo número de instâncias a reservar.

  • ZONE: a zona onde a reserva está localizada.

REST

Para modificar o número de instâncias reservadas numa reserva, faça um POST pedido ao método reservations.resize.

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize

{
  "specificSkuCount": "NUMBER_OF_VMS"
}

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde a reserva se encontra.

  • ZONE: a zona onde a reserva está localizada.

  • RESERVATION_NAME: o nome de uma reserva existente.

  • NUMBER_OF_VMS: o novo número de instâncias a reservar.

Modifique a política de partilha de uma reserva

Quando modifica a política de partilha de uma reserva de instâncias de computação de GPU, controla se as tarefas de preparação ou previsão do Vertex AI consomem a reserva.

Antes de impedir que as tarefas do Vertex AI consumam uma reserva, pare todas as tarefas do Vertex AI que a usam. Caso contrário, ocorrem erros.

Para modificar a política de partilha de uma reserva de instâncias de GPU, selecione uma das seguintes opções:

Consola

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

    Aceda a Reservas

  2. No separador Reservas a pedido (predefinição), na coluna Nome, clique no nome da reserva de instâncias de GPU que quer modificar. É apresentada uma página com os detalhes da reserva.

  3. Na linha Partilhar com outros serviços do Google Cloud, clique em Editar definições de partilha de serviços.

  4. No painel Partilhar reserva, efetue uma das seguintes ações:

    • Para permitir que as tarefas do Vertex AI consumam a reserva, selecione Partilhar reserva.

    • Para não permitir que as tarefas do Vertex AI consumam a reserva, selecione Não partilhar reserva.

  5. Clique em Guardar.

    A modificação da reserva pode demorar alguns segundos a ser concluída.

gcloud

Para modificar a política de partilha de uma reserva de instâncias de GPU, use o comando gcloud compute reservations update com a flag --reservation-sharing-policy.

gcloud compute reservations update RESERVATION_NAME \
    --reservation-sharing-policy=SHARING_POLICY \
    --zone=ZONE

Substitua o seguinte:

  • RESERVATION_NAME: o nome de uma reserva existente.

  • SHARING_POLICY: a política de partilha da reserva. Especifique um dos seguintes valores:

    • Para permitir que as tarefas do Vertex AI consumam a reserva: ALLOW_ALL

    • Para impedir que as tarefas do Vertex AI consumam a reserva: DISALLOW_ALL

  • ZONE: a zona onde existe a reserva

REST

Para modificar a política de partilha de uma reserva de instâncias de GPU, faça um pedido para o método reservations.update.PATCH No URL do pedido, inclua o parâmetro de consulta paths definido como reservationSharingPolicy.serviceShareType.

PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType

{
  "name": "RESERVATION_NAME",
  "reservationSharingPolicy": {
    "serviceShareType": "SHARING_POLICY"
  }
}

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde a reserva existe.

  • ZONE: a zona onde existe a reserva.

  • RESERVATION_NAME: o nome de uma reserva existente.

  • SHARING_POLICY: a política de partilha da reserva. Especifique um dos seguintes valores:

    • Para permitir que as tarefas do Vertex AI consumam a reserva: ALLOW_ALL

    • Para impedir que as tarefas do Vertex AI consumam a reserva: DISALLOW_ALL

Altere outras propriedades numa reserva

Se quiser modificar uma propriedade que não é mencionada na secção Modificar reservas, tem de criar uma reserva de substituição.

Para substituir uma reserva sem arriscar uma redução não intencional na capacidade reservada, faça o seguinte:

  1. Crie uma nova reserva de projeto único ou reserva partilhada com propriedades atualizadas.

  2. Se já não precisar da reserva original, elimine-a.

O que se segue?