Aumentar a capacidade de uma instância do Managed Lustre

É possível aumentar a capacidade de armazenamento da sua instância do Managed Lustre. A capacidade não pode ser reduzida.

Para aumentar a capacidade da sua instância do Managed Lustre, faça o seguinte:

  • Determine sua nova capacidade.
  • Use o console do Google Cloud ou a Google Cloud CLI para atualizar a capacidade da instância.
  • Monitorar a atualização. Você pode continuar usando a instância enquanto a operação de atualização está em andamento.

Calcular sua nova capacidade

É possível atualizar a capacidade de uma instância até o valor máximo permitido para o nível de desempenho dela. Estes são os valores:

Nível Capacidade mínima Capacidade máxima Taxa de aprendizado
125 MBps por TiB 72.000 GiB 12.240.000 GiB (11,67 PiB) 72.000 GiB
250 MBps por TiB 36.000 GiB 6.120.000 GiB (5,84 PiB) 36.000 GiB
500 MBps por TiB 18.000 GiB 3.060.000 GiB (2,92 PiB) 18.000 GiB
1.000 MBps por TiB 9.000 GiB 1.530.000 GiB (1,46 PiB) 9.000 GiB

A capacidade atualizada precisa ser um múltiplo do tamanho da etapa.

Seu projeto Google Cloud tem limites e cotas do sistema que afetam a capacidade disponível por rede de nuvem privada virtual (VPC) por zona. Talvez seja necessário solicitar mais cota antes de aumentar a capacidade da instância. Consulte a seção Cotas e limites para mais detalhes.

Atualizar a capacidade da instância

Use o console do Google Cloud ou a Google Cloud CLI para atualizar a capacidade da instância.

Console do Google Cloud

  1. Acesse a página Lustre gerenciado no console do Google Cloud .

    Acessar o Managed Lustre

  2. Clique no Nome da instância da instância que você quer atualizar. A página de visão geral da instância é exibida.

  3. Clique em Editar.

  4. Insira o novo valor de capacidade de armazenamento. O valor precisa ser igual ou menor que a capacidade máxima permitida e ser um múltiplo da taxa de incremento. Consulte Calcular sua nova capacidade para conferir esses valores.

  5. Clique em Enviar.

gcloud

Use o comando gcloud lustre instances update para aumentar a capacidade de armazenamento da instância:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY

Em que:

  • INSTANCE_NAME é a instância a ser atualizada.
  • LOCATION é a zona em que a instância reside.
  • NEW_CAPACITY é a nova capacidade de armazenamento para essa instância em gibibytes (GiB). O valor não pode exceder a capacidade máxima permitida e precisa ser um múltiplo da taxa de incremento. Consulte Calcular sua nova capacidade para conferir esses valores.

REST

Para atualizar uma instância usando a API REST, envie uma solicitação PATCH ao endpoint específico dela:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=capacityGib
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": NEW_CAPACITY
}

Em que os seguintes valores precisam ser especificados:

  • PROJECT_ID é o ID do projeto Google Cloud .
  • ZONE é a Google Cloud zona da instância.
  • INSTANCE_NAME é o nome da instância gerenciada do Lustre a ser atualizada.
  • updateMask=capacityGib especifica o campo a ser atualizado. Um campo só será substituído se estiver na máscara.
  • NEW_CAPACITY é a nova capacidade de armazenamento para essa instância em gibibytes (GiB). O valor não pode exceder a capacidade máxima permitida e precisa ser um múltiplo da taxa de incremento. Consulte Calcular sua nova capacidade para conferir esses valores.

Consulte a referência da API instances.patch para mais detalhes.

Depois que a solicitação de atualização for enviada, o Managed Lustre vai verificar sua cota disponível. Se houver cota suficiente, a capacidade da instância será aumentada ao longo de um período, dependendo da mudança de tamanho. Os aumentos podem levar de 20 minutos a uma hora ou mais.

Você pode continuar usando a instância durante a operação de atualização.

Ver status da atualização

Você pode conferir o status de uma solicitação de atualização nas seguintes interfaces:

Console do Google Cloud

  1. Acesse a página Lustre gerenciado no console do Google Cloud .

    Acessar o Managed Lustre

  2. Clique no nome da instância na lista. A página Detalhes da instância aparece, incluindo o status atual da solicitação de atualização da instância.

gcloud

Por padrão, o comando gcloud lustre instances update aguarda a conclusão antes de retornar o prompt do shell:

Request issued for: [my-instance]
Waiting for operation [projects/my-project/locations/us-central1-a/operations/operation-1234567890-123] to complete...

Quando concluída, a linha de comando mostra Updated instance [my-instance] junto com os detalhes da instância, incluindo a capacidade atualizada.

Se você executou o comando de atualização com a flag --async ou precisa consultar o status da atualização na linha de comando, recupere os detalhes da operação para verificar se a atualização da instância foi concluída:

gcloud lustre operations describe OPERATION_ID \
  --location=ZONE

Enquanto a instância é atualizada, a resposta mostra um valor done: false. Quando a operação for concluída, done será definido como true.

Exemplo:

$ gcloud lustre operations describe operation-1234567890-123abc456-789def012-a1b2c3d4 \
    --location=us-central1-a

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.lustre.v1.OperationMetadata
  apiVersion: v1
  createTime: '2025-08-27T18:13:49.771203623Z'
  requestedCancellation: false
  target: projects/my-project/locations/us-central1-a/instances/my-instance
  verb: update
name: projects/my-project/locations/us-central1-a/operations/operation-1234567890-123abc456-789def012-a1b2c3d4

REST

Para consultar o status de uma operação de atualização, use o ID da operação da resposta. O ID da operação tem o seguinte formato:

  • operation-1234567890123-6127783ad26ea-88913969-02748053

Envie uma solicitação para o seguinte endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID
Authorization: Bearer

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Performance após aumentar a capacidade

A capacidade de processamento máxima de uma instância do Managed Lustre é determinada pela capacidade de armazenamento e pelo nível de desempenho dela. Aumentar a capacidade de armazenamento de uma instância também aumenta a taxa de transferência máxima dela.

O aumento de performance só vai aparecer depois que novos dados forem gravados. O desempenho de capacidade melhora gradualmente à medida que novos dados são gravados e redistribuídos no armazenamento adicional.