É possível aumentar a capacidade de armazenamento da instância do Managed Lustre. A capacidade não pode ser reduzida.
Para aumentar a capacidade da instância do Managed Lustre, faça o seguinte:
- Determine sua nova capacidade.
- Use o Google Cloud console ou a Google Cloud CLI para atualizar a capacidade da instância.
- Monitore a atualização. É possível 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. Confira 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 da taxa de aprendizado.
Seu Google Cloud projeto 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 uma cota extra antes de aumentar a capacidade da instância. Consulte Cotas e limites para mais detalhes.
Atualizar a capacidade da instância
Use o Google Cloud console ou a Google Cloud CLI para atualizar a capacidade da instância.
Google Cloud Console do
Acesse a página Managed Lustre no Google Cloud console.
Clique no Nome da instância que você quer atualizar. A página de visão geral da instância é exibida.
Clique em Editar.
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.
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 dessa 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 aprendizado. Consulte Calcular sua nova capacidade para conferir esses valores.
REST
Para atualizar uma instância usando a API REST, envie uma solicitação PATCH para o 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 seu Google Cloud projeto.
- ZONE é azona da instância Google Cloud .
- INSTANCE_NAME é o nome da instância do Managed Lustre a ser atualizada.
updateMask=capacityGibespecifica o campo a ser atualizado. Um campo só será substituído se estiver na máscara.- NEW_CAPACITY é a nova capacidade de armazenamento dessa 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 aprendizado. 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 durante um período, dependendo da mudança de tamanho. Os aumentos podem levar de 20 minutos a uma hora ou mais.
É possível continuar usando a instância durante a operação de atualização.
Conferir o status da atualização
É possível conferir o status de uma solicitação de atualização nas seguintes interfaces.
Google Cloud Console do
Acesse a página Managed Lustre no Google Cloud console.
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 conferir se a instância terminou de atualizar:
gcloud lustre operations describe OPERATION_ID \
--location=ZONE
Enquanto a instância está sendo atualizada, a resposta mostra um valor done: false.
Quando concluída, done é 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.
Desempenho após o aumento da 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. Aumentar a capacidade de armazenamento de uma instância atual também aumenta a capacidade de processamento máxima.
O aumento de desempenho só será percebido depois que novos dados forem gravados. O desempenho da taxa de transferência melhora gradualmente à medida que novos dados são gravados e redistribuídos no armazenamento extra.