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.

Ao aumentar a capacidade de uma instância, é possível continuar usando-a enquanto a operação de atualização está em andamento.

Limitações no aumento da capacidade

Para níveis de desempenho com duas taxas de aprendizado diferentes, a capacidade atual da instância determina o tamanho máximo possível.

Se a capacidade de uma instância estiver abaixo ou no limite do tamanho da etapa, o tamanho dela poderá ser aumentado até o valor limite. Não é possível expandir além desse limite.

Por exemplo, no nível de 250 MBps por TiB, o limite em que o tamanho da etapa muda é de 6.120.000 GiB. Qualquer instância criada com uma capacidade igual ou inferior a esse limite só pode ser expandida até o limite de 6.120.000 GiB.

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 e o tamanho da etapa. Estes são os valores:

Nível Capacidade mínima Capacidade máxima Taxa de aprendizado
1.000 MBps por TiB 9.000 GiB 10.008.000 GiB (9,5 PiB) Para capacidades de armazenamento de até 1.530.000 GiB: 9.000 GiB
Para capacidades de armazenamento maiores: 72.000 GiB
500 MBps por TiB 18.000 GiB 20.016.000 GiB (19,1 PiB) Para capacidades de armazenamento de até 3.060.000 GiB: 18.000 GiB
Para capacidades de armazenamento maiores: 144.000 GiB
250 MBps por TiB 36.000 GiB 40.032.000 GiB (38,2 PiB) Para capacidades de armazenamento de até 6.120.000 GiB: 36.000 GiB
Para capacidades de armazenamento maiores: 288.000 GiB
125 MBps por TiB 72.000 GiB 12.240.000 GiB (11,7 PiB) 72.000 GiB
Dinâmico (25 MBps por TiB) 472.000 GiB 84.016.000 GiB (80,1 PiB) 472.000 GiB

A capacidade atualizada precisa ser um múltiplo da taxa de aprendizado e não pode exceder o máximo para esse tamanho.

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 Cotas e limites para mais detalhes.

Calculadora de capacidade

Use a calculadora abaixo para encontrar uma capacidade válida para o nível de desempenho selecionado.

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 Managed Lustre 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 precisa ser um múltiplo da taxa de aprendizado. 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 do Managed 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 o 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 Managed Lustre 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 instância terminou de ser atualizada:

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 de processamento aumenta gradualmente à medida que novos dados são gravados e redistribuídos no armazenamento extra.