Modificar reservas

Este documento explica como modificar reservas. Para modificar reservas anexadas a compromissos, consulte Substituir reservas anexadas a compromissos .

Modifique uma reserva quando, por exemplo, sua capacidade precisar ser alterada ou você quiser alterar quais cargas de trabalho podem consumir uma reserva.

Limitações

Antes de modificar uma reserva, considere o seguinte:

  • Você só pode modificar uma reserva compartilhada no mesmo projeto onde a criou.

  • Você só poderá modificar uma reserva criada automaticamente para uma reserva futura após o término do período de reserva.

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Funções obrigatórias

Para obter as permissões necessárias para modificar reservas, peça ao administrador para conceder a você a função do IAM Compute Admin ( roles/compute.admin ) no projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Esta função predefinida contém as permissões necessárias para modificar reservas. Para ver 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 modificar reservas:

  • Para modificar a opção de exclusão automática em uma reserva, o consumidor projeta em uma reserva compartilhada ou se os trabalhos da 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 em uma reserva: compute.reservations.resize no projeto

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Modificar reservas

Com base nas propriedades que você deseja modificar em uma reserva, use um dos seguintes métodos:

Para alterar quaisquer propriedades que não estejam mencionadas nesta lista, você deve criar uma nova reserva. Para obter instruções, consulte Alterar outras propriedades em uma reserva neste documento.

Modificar a exclusão automática de uma reserva

Você pode modificar quando o Compute Engine exclui automaticamente uma reserva existente seguindo um destes procedimentos:

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

Console

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

    Ir para Reservas

  2. Na guia Reservas sob demanda (padrão), na coluna Nome , clique no nome da reserva que você deseja modificar.

    A página de detalhes da reserva é aberta.

  3. Na linha Hora de exclusão automática , clique em Editar hora de exclusão automática .

  4. No painel Atualizar reserva , siga um destes procedimentos:

    • Para excluir a reserva em uma data e hora específicas, faça o seguinte:

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

      2. No campo Hora de exclusão automática , insira a data e a hora em que o Compute Engine excluirá automaticamente a reserva.

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

  5. Clique em Enviar .

    A modificação da sua reserva pode levar alguns segundos para ser concluída.

gcloud

Ao ativar a opção de exclusão automática em uma reserva, você pode especificar uma data e hora em que a reserva deve ser excluída ou especificar um período após o qual a reserva deve ser excluída.

Para ativar a opção de exclusão automática ou alterar quando a reserva deve ser excluída, siga um destes procedimentos:

  • Para excluir a reserva em uma data e hora específicas, use o comando gcloud beta compute reservations update com a sinalização --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 hora formatada como um carimbo de data/hora RFC 3339 .

    • ZONE : a zona onde se encontra a reserva.

  • Para excluir a reserva após um período específico, use o comando gcloud beta compute reservations update com a sinalização --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 da reserva ser excluída automaticamente. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.

    • ZONE : a zona onde se encontra a reserva.

Para desativar a opção de exclusão automática, use o comando gcloud beta compute reservations update com a sinalização --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 se encontra a reserva.

DESCANSAR

Ao ativar a opção de exclusão automática em uma reserva, você pode especificar uma data e hora em que a reserva deve ser excluída ou especificar um período após o qual a reserva deve ser excluída.

Para ativar a opção de exclusão automática ou alterar quando a reserva deve ser excluída, siga um destes procedimentos:

  • Para excluir a reserva em uma data e horário específico, faça uma solicitação PATCH ao método beta.reservations.update . No URL de solicitação, inclua o parâmetro de consulta paths definido como deleteAtTime .

    PATCH https://compute.googleapis.com/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 a reserva está localizada.

    • ZONE : a zona onde se encontra a reserva.

    • RESERVATION_NAME : o nome de uma reserva existente.

    • DELETE_AT_TIME : uma data e hora formatada como um carimbo de data/hora RFC 3339 .

  • Para excluir a reserva após um período específico, faça uma solicitação PATCH ao método beta.reservations.update . No URL de solicitação, inclua o parâmetro de consulta paths definido como deleteAfterDuration.seconds .

    PATCH https://compute.googleapis.com/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 a reserva está localizada.

    • ZONE : a zona onde se encontra a reserva.

    • RESERVATION_NAME : o nome de uma reserva existente.

    • DELETE_AFTER_DURATION : uma duração em segundos antes da reserva ser excluída automaticamente. Por exemplo, especifique 86400 para 86.400 segundos (1 dia).

Para desativar a opção de exclusão automática, faça uma solicitação PATCH ao método beta.reservations.update . Na solicitação, especifique o parâmetro de consulta paths=deleteAtTime&paths=deleteAfterDuration e omita o corpo da solicitação.

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

Substitua o seguinte:

  • PROJECT_ID : o ID do projeto onde a reserva está localizada.

  • ZONE : a zona onde se encontra a reserva.

  • RESERVATION_NAME : o nome de uma reserva existente.

Modificar os projetos consumidores em uma reserva compartilhada

Você só poderá permitir que projetos consumam uma reserva compartilhada se esses projetos estiverem localizados na mesma organização que o projeto proprietário. Para saber como migrar um projeto para a organização do projeto proprietário, consulte Migrando projetos entre recursos da organização na documentação do Resource Manager.

Depois de modificar quais projetos consumidores podem consumir uma reserva compartilhada, o consumo da reserva poderá mudar. Por exemplo, qualquer projeto consumidor removido deixa de consumir recursos da reserva. Além disso, se a reserva tiver sido configurada para ser consumida automaticamente por qualquer VM que corresponda às propriedades da reserva (o comportamento padrão), qualquer projeto consumidor adicionado poderá começar a consumir recursos da reserva. Se você deseja monitorar o consumo de uma reserva, veja como verificar o consumo de reservas .

Para modificar os projetos consumidores que podem consumir uma reserva compartilhada, selecione uma das seguintes opções:

Console

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

    Ir para Reservas

  2. Na guia Reservas sob demanda (padrão), na coluna Nome , clique no nome da reserva que deseja descrever.

    A página de detalhes da reserva é aberta.

  3. Clique em Editar .

  4. Na seção Projetos selecionados , siga um destes procedimentos:

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

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

      1. Clique em Adicionar projetos .

      2. Marque a caixa de seleção de cada projeto da organização do projeto proprietário com quem você deseja compartilhar a reserva.

      3. Clique em Selecionar .

  5. Para confirmar suas alterações, clique em Salvar .

    A modificação da sua reserva pode levar alguns segundos para ser concluída.

gcloud

Ao modificar os projetos consumidores para uma reserva compartilhada, você deve especificar uma lista separada por vírgulas de IDs de projetos que deseja permitir ou parar de permitir o consumo da reserva compartilhada. Esses projetos devem estar na mesma organização que o projeto proprietário. Não especifique o projeto proprietário na lista. Por padrão, já é permitido consumir a reserva compartilhada.

Para modificar os projetos consumidores de uma reserva compartilhada, selecione um dos seguintes métodos:

  • Para permitir que um ou mais projetos consumam uma reserva compartilhada, use o comando gcloud compute reservations update com a sinalização --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 compartilhada existente.

    • CONSUMER_PROJECT_IDS : uma lista separada por vírgulas de IDs de projetos com os quais compartilhar a reserva. Por exemplo, especifique project-1,project-2 .

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

  • Para parar de permitir que um ou mais projetos consumam uma reserva compartilhada, use o comando gcloud compute reservations update com a sinalização --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 compartilhada existente.

    • CONSUMER_PROJECT_IDS : uma lista separada por vírgulas de IDs de projetos com os quais você deseja parar de compartilhar a reserva. Por exemplo, especifique project-1,project-2 .

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

  • Para substituir a lista de projetos que podem consumir uma reserva compartilhada, use o comando gcloud beta compute reservations update com a sinalização --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 compartilhada existente.

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

    • CONSUMER_PROJECT_IDS : uma lista separada por vírgulas de IDs de projetos com os quais compartilhar a reserva. Por exemplo, especifique project-1,project-2 .

DESCANSAR

Ao modificar os projetos consumidores para uma reserva compartilhada, você deve especificar os IDs dos projetos que deseja permitir ou parar de permitir o consumo da reserva compartilhada. Esses projetos devem estar na mesma organização que o projeto proprietário. Não especifique o projeto proprietário. Por padrão, já é permitido consumir a reserva compartilhada.

Para modificar os projetos consumidores de uma reserva compartilhada, selecione um dos seguintes métodos:

  • Para permitir que um ou mais projetos consumam uma reserva compartilhada, faça uma solicitação PATCH ao método reservations.update . No URL de solicitação, inclua paths=shareSettings.projectMap. PROJECT_ID Parâmetro de consulta paths=shareSettings.projectMap. PROJECT_ID para cada projeto com o qual você deseja compartilhar a reserva.

    Por exemplo, para permitir que dois projetos consumam uma reserva compartilhada, faça a seguinte solicitação PATCH : 

    PATCH https://compute.googleapis.com/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 compartilhada.

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

    • RESERVATION_NAME : o nome de uma reserva compartilhada existente.

    • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2 : os IDs de dois projetos com os quais você deseja compartilhar a reserva.

  • Para parar de permitir que um ou mais projetos consumam uma reserva compartilhada, faça uma solicitação PATCH ao método reservations.update . No URL de solicitação, inclua paths=shareSettings.projectMap. PROJECT_ID Parâmetro de consulta paths=shareSettings.projectMap. PROJECT_ID para cada projeto com o qual você deseja parar de compartilhar a reserva. Além disso, você deve omitir o campo shareSetting do corpo da solicitação.

    Por exemplo, para parar de permitir que dois projetos consumam uma reserva compartilhada, faça a seguinte solicitação PATCH : 

    PATCH https://compute.googleapis.com/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 compartilhada.

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

    • RESERVATION_NAME : o nome de uma reserva compartilhada existente.

    • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2 : os IDs de dois projetos com os quais você deseja parar de compartilhar a reserva.

Modifique o número de instâncias reservadas em uma reserva

Você pode aumentar ou diminuir o número de instâncias de computação reservadas em uma 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 do seguinte:

  • Para diminuir o número de instâncias em uma reserva específica , certifique-se de que o número de instâncias que consomem a reserva não exceda o novo número menor. Em caso afirmativo, faça o seguinte com as instâncias que excedem o novo número:

    • Excluir instâncias

    • Pare ou suspenda as instâncias

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

Console

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

    Ir para Reservas

  2. Na guia Reservas sob demanda (padrão), na coluna Nome , clique no nome da reserva que você deseja modificar.

    A página de detalhes da reserva é aberta.

  3. Clique em Editar .

  4. No campo Número de instâncias de VM , insira o número atualizado de instâncias a serem reservadas.

  5. Para confirmar, clique em Salvar .

    A modificação da sua reserva pode levar alguns segundos para ser concluída.

gcloud

Para modificar o número de instâncias reservadas em uma 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 serem reservadas.

  • ZONE : a zona onde se encontra a reserva.

DESCANSAR

Para modificar o número de instâncias reservadas em uma reserva, faça uma solicitação POST ao método reservations.resize . 

POST https://compute.googleapis.com/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 está localizada.

  • ZONE : a zona onde se encontra a reserva.

  • RESERVATION_NAME : o nome de uma reserva existente.

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

Modificar a política de compartilhamento de uma reserva

Ao modificar a política de compartilhamento de uma reserva de instâncias de computação de GPU, você pode permitir ou proibir que jobs de treinamento personalizados ou de previsão no Vertex AI consumam a reserva.

Se você quiser impedir que a Vertex AI consuma uma reserva, antes de modificar a reserva, certifique-se de que nenhum trabalho de treinamento personalizado ou trabalho de previsão esteja consumindo a reserva. Caso contrário, você encontrará erros.

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

Console

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

    Ir para Reservas

  2. Na guia Reservas sob demanda (padrão), na coluna Nome , clique no nome da reserva de instâncias de GPU que você deseja modificar.

    A página de detalhes da reserva é aberta.

  3. Na linha Compartilhar com outros serviços do Google Cloud , clique em Editar configurações de compartilhamento de serviço .

  4. No painel Compartilhamento de reserva , siga um destes procedimentos:

    • Para permitir que a Vertex AI consuma a reserva, selecione Compartilhar reserva .

    • Para impedir que a Vertex AI consuma a reserva, selecione Não compartilhar reserva .

  5. Clique em Salvar .

    A modificação da sua reserva pode levar alguns segundos para ser concluída.

gcloud

Para modificar a política de compartilhamento de uma reserva de instâncias de GPU, use o comando gcloud compute reservations update com a sinalização --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 compartilhamento da reserva. Especifique um dos seguintes valores:

    • Para permitir que a Vertex AI consuma a reserva: ALLOW_ALL

    • Para impedir que a Vertex AI consuma a reserva: DISALLOW_ALL

  • ZONE : a zona onde se encontra a reserva.

DESCANSAR

Para modificar a política de compartilhamento de uma reserva de instâncias de GPU, faça uma solicitação PATCH ao método reservations.update . Na URL da solicitação, inclua o parâmetro de consulta paths definido como reservationSharingPolicy.serviceShareType . 

PATCH https://compute.googleapis.com/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 está localizada.

  • ZONE : a zona onde se encontra a reserva.

  • RESERVATION_NAME : o nome de uma reserva existente.

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

    • Para permitir que a Vertex AI consuma a reserva: ALLOW_ALL

    • Para impedir que a Vertex AI consuma a reserva: DISALLOW_ALL

Alterar outras propriedades em uma reserva

Se quiser modificar uma propriedade que não esteja mencionada na seção Modificar reservas , você deverá criar uma reserva substituta.

Para substituir uma reserva sem correr o risco de uma redução involuntária na sua capacidade reservada, faça o seguinte:

  1. Crie um novo projeto único ou reserva compartilhada com propriedades atualizadas.

  2. Se você não precisar mais da reserva original, exclua a reserva .

Solucionar problemas

Saiba como solucionar problemas com atualizações de reservas .

O que vem a seguir