Vous pouvez augmenter la capacité de stockage de votre instance Managed Lustre. Vous ne pourrez pas réduire la capacité.
Pour augmenter la capacité de votre instance Managed Lustre :
- Déterminez votre nouvelle capacité.
- Utilisez la console Google Cloud ou la Google Cloud CLI pour mettre à jour la capacité de l'instance.
- Surveillance de la mise à jour. Vous pouvez continuer à utiliser votre instance pendant l'opération de mise à jour.
Calculer votre nouvelle capacité
Vous pouvez augmenter la capacité d'une instance jusqu'à la valeur maximale autorisée pour son niveau de performances. Ces valeurs sont les suivantes :
| Niveau | Capacité minimale | Capacité maximale | Taille de pas |
|---|---|---|---|
| 125 MBps par Tio | 72 000 Gio | 12 240 000 Gio (11,67 Pio) | 72 000 Gio |
| 250 MBps par Tio | 36 000 Gio | 6 120 000 Gio (5,84 Pio) | 36 000 Gio |
| 500 MBps par Tio | 18 000 Gio | 3 060 000 Gio (2,92 Pio) | 18 000 Gio |
| 1 000 MBps par Tio | 9 000 Gio | 1 530 000 Gio (1,46 Pio) | 9 000 Gio |
La capacité mise à jour doit être un multiple de la taille du pas.
Votre projet Google Cloud comporte des limites et des quotas système qui affectent la capacité disponible par réseau de cloud privé virtuel (VPC) et par zone. Vous devrez peut-être demander un quota supplémentaire avant d'augmenter la capacité de votre instance. Pour en savoir plus, consultez la section Quotas et limites.
Mettre à jour la capacité de l'instance
Vous pouvez utiliser la console Google Cloud ou la Google Cloud CLI pour mettre à jour la capacité de l'instance.
Console Google Cloud
Accédez à la page Managed Lustre dans la console Google Cloud .
Cliquez sur le nom de l'instance à mettre à jour. La page de présentation de l'instance s'affiche.
Cliquez sur Modifier.
Saisissez la nouvelle valeur de capacité de stockage. La valeur doit être inférieure ou égale à la capacité maximale autorisée et doit être un multiple de la taille du pas. Pour obtenir ces valeurs, consultez Calculer votre nouvelle capacité.
Cliquez sur Envoyer.
gcloud
Utilisez la commande gcloud lustre instances update pour augmenter la capacité de stockage de votre instance :
gcloud lustre instances update INSTANCE_NAME \
--location=LOCATION \
--capacity-gib=NEW_CAPACITY
Où :
- INSTANCE_NAME est l'instance à mettre à jour.
- LOCATION est la zone dans laquelle se trouve l'instance.
- NEW_CAPACITY est la nouvelle capacité de stockage de cette instance en gibioctets (Gio). La valeur ne peut pas dépasser la capacité maximale autorisée et doit être un multiple de la taille du pas. Pour connaître ces valeurs, consultez Calculer votre nouvelle capacité.
REST
Pour mettre à jour une instance à l'aide de l'API REST, envoyez une requête PATCH à son point de terminaison spécifique :
PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=capacityGib
Authorization: Bearer [YOUR_ACCESS_TOKEN]
{
"capacityGib": NEW_CAPACITY
}
Les valeurs suivantes doivent être spécifiées :
- PROJECT_ID est l'ID de votre projet Google Cloud .
- ZONE est la zone Google Cloud de l'instance.
- INSTANCE_NAME correspond au nom de l'instance Managed Lustre à mettre à jour.
updateMask=capacityGibspécifie le champ à mettre à jour. Un champ ne sera écrasé que s'il figure dans le masque.- NEW_CAPACITY est la nouvelle capacité de stockage de cette instance en gibioctets (Gio). La valeur ne peut pas dépasser la capacité maximale autorisée et doit être un multiple de la taille du pas. Pour connaître ces valeurs, consultez Calculer votre nouvelle capacité.
Pour en savoir plus, consultez la documentation de référence de l'API instances.patch.
Une fois la demande de mise à jour envoyée, Managed Lustre vérifie votre quota disponible. Si le quota est suffisant, la capacité de l'instance est augmentée sur une période donnée, en fonction de l'ampleur de la modification. Les augmentations peuvent prendre de 20 minutes à une heure ou plus.
Vous pouvez continuer à utiliser votre instance pendant l'opération de mise à jour.
Afficher l'état de la mise à jour
Vous pouvez consulter l'état d'une demande de mise à jour depuis les interfaces suivantes.
Console Google Cloud
Accédez à la page Managed Lustre dans la console Google Cloud .
Cliquez sur le nom de l'instance dans la liste. La page Détails de l'instance s'affiche. Elle inclut l'état actuel de votre demande de mise à jour de l'instance.
gcloud
Par défaut, la commande gcloud lustre instances update attend la fin de l'opération avant de renvoyer l'invite de ligne de commande :
Request issued for: [my-instance]
Waiting for operation [projects/my-project/locations/us-central1-a/operations/operation-1234567890-123] to complete...
Une fois l'opération terminée, la ligne de commande affiche Updated instance [my-instance] ainsi que les détails de l'instance, y compris la capacité mise à jour.
Si vous avez exécuté la commande de mise à jour avec l'indicateur --async ou si vous devez interroger l'état de la mise à jour à partir de la ligne de commande, vous pouvez récupérer les détails de l'opération pour voir si la mise à jour de l'instance est terminée :
gcloud lustre operations describe OPERATION_ID \
--location=ZONE
Pendant la mise à jour de l'instance, la réponse affiche la valeur done: false.
Une fois l'opération terminée, done est défini sur true.
Exemple :
$ 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
Pour interroger l'état d'une opération de mise à jour, utilisez l'ID d'opération de la réponse. L'ID de l'opération est au format suivant :
operation-1234567890123-6127783ad26ea-88913969-02748053
Envoyez une requête au point de terminaison suivant :
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID
Authorization: Bearer
Si elle aboutit, le corps de la réponse contient une instance d'Operation.
Performances après l'augmentation de la capacité
Le débit maximal d'une instance Managed Lustre est déterminé par sa capacité de stockage et son niveau de performances. L'augmentation de la capacité de stockage d'une instance existante augmente également son débit maximal.
L'amélioration des performances ne sera peut-être visible qu'une fois que de nouvelles données auront été écrites. Les performances de débit s'améliorent progressivement à mesure que de nouvelles données sont écrites et redistribuées dans l'espace de stockage supplémentaire.