Vous pouvez augmenter la capacité de stockage de votre instance Managed Lustre. Vous ne pouvez pas la réduire.
Lorsque vous augmentez la capacité d'une instance, vous pouvez continuer à l'utiliser pendant l'opération de mise à jour.
Limites concernant l'augmentation de la capacité
Pour les niveaux de performances avec deux tailles d'étape différentes, la capacité actuelle de l'instance détermine sa taille maximale possible.
Si la capacité d'une instance est inférieure ou égale au seuil de taille de pas, sa taille peut être augmentée jusqu'à la valeur seuil elle-même. Elle ne peut pas être étendue au-delà de cette limite.
Par exemple, dans le niveau 250 MBps par Tio, le seuil auquel la taille de pas change est de 6 120 000 Gio. Toute instance créée avec une capacité inférieure ou égale à ce seuil ne peut être étendue que jusqu'à cette limite de 6 120 000 Gio.
Calculer votre nouvelle capacité
Vous pouvez mettre à jour la capacité d'une instance jusqu'à la valeur maximale autorisée pour son niveau de performances et sa taille de pas. Ces valeurs sont les suivantes :
| Niveau | Capacité minimale | Capacité maximale | Taille d'étape |
|---|---|---|---|
| 1 000 MBps par Tio | 9 000 Gio | 10 008 000 Gio (9,5 Pio) | Pour les capacités de stockage allant jusqu'à 1 530 000 Gio : 9 000 Gio Pour les capacités de stockage supérieures : 72 000 Gio |
| 500 MBps par Tio | 18 000 Gio | 20 016 000 Gio (19,1 Pio) | Pour les capacités de stockage allant jusqu'à 3 060 000 Gio : 18 000 Gio Pour les capacités de stockage supérieures : 144 000 Gio |
| 250 MBps par Tio | 36 000 Gio | 40 032 000 Gio (38,2 Pio) | Pour les capacités de stockage allant jusqu'à 6 120 000 Gio : 36 000 Gio Pour les capacités de stockage supérieures : 288 000 Gio |
| 125 MBps par Tio | 72 000 Gio | 12 240 000 Gio (11,7 Pio) | 72 000 Gio |
| Dynamique (25 MBps par Tio) | 472 000 Gio | 84 016 000 Gio (80,1 Pio) | 472 000 Gio |
La capacité mise à jour doit être un multiple de la taille de pas et ne peut pas dépasser le maximum pour cette taille de pas.
Votre Google Cloud projet est soumis à des limites et des quotas système qui affectent la capacité disponible par réseau 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.
Calculateur de capacité
Utilisez le calculateur suivant pour trouver une capacité valide pour le niveau de performances sélectionné.
Mettre à jour la capacité de l'instance
Vous pouvez utiliser la Google Cloud console ou la Google Cloud CLI pour mettre à jour la capacité de l'instance.
Google Cloud Console
Accédez à la page Managed Lustre dans la Google Cloud console.
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 de pas. Pour connaître ces valeurs, consultez la section Calculer votre nouvelle capacité.
Cliquez sur Envoyer.
gcloud
Utilisez la gcloud lustre instances update commande pour augmenter la
capacité de stockage de votre instance :
gcloud lustre instances update INSTANCE_NAME \
--location=LOCATION \
--capacity-gib=NEW_CAPACITY
Où :
- INSTANCE_NAME correspond à l'instance à mettre à jour.
- LOCATION correspond à la zone dans laquelle se trouve l'instance.
- NEW_CAPACITY correspond à 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 de pas. Pour connaître ces valeurs, consultez la section 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
}
Où les valeurs suivantes doivent être spécifiées :
- PROJECT_ID correspond à l'ID de votre Google Cloud projet.
- ZONE correspond à la Google Cloud zone de l'instance.
- INSTANCE_NAME correspond au nom de l'instance Managed Lustre à mettre à jour.
updateMask=capacityGibspécifie le champ à mettre à jour. Un champ n'est remplacé que s'il figure dans le masque.- NEW_CAPACITY correspond à 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 de pas. Pour connaître ces valeurs, consultez la section 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 la modification de la taille. L'augmentation peut prendre entre 20 minutes et une heure, voire plus.
Vous pouvez continuer à utiliser votre instance pendant l'opération de mise à jour.
Afficher l'état de la mise à jour
Vous pouvez afficher l'état d'une demande de mise à jour à partir des interfaces suivantes.
Google Cloud Console
Accédez à la page Managed Lustre dans la Google Cloud console.
Cliquez sur le nom de l'instance dans la liste. La page Détails de l'instance s'affiche, y compris 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 l'interface système :
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 d'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 de 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 le stockage supplémentaire.