Increase the capacity of a Managed Lustre instance

Google Cloud console

1. Go to the Managed Lustre page in the Google Cloud console.

   Go to Managed Lustre

2. Click the Instance name of the instance to update. The instance overview page is displayed.

3. Click Edit.

4. Enter the new storage capacity value. The value must be equal to or less than the maximum allowed capacity, and must be a multiple of the step size. See Calculate your new capacity for these values.

5. Click Submit.

gcloud

Use the gcloud lustre instances update command to increase your instance's storage capacity:

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

Where:

• INSTANCE_NAME is the instance to update.
• LOCATION is the zone in which the instance resides.
• NEW_CAPACITY is the new storage capacity for this instance in gibibytes (GiB). The value cannot exceed the maximum allowed capacity and must be a multiple of the step size. See Calculate your new capacity for these values.

REST

To update an instance using the REST API, send a PATCH request to its specific endpoint:

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

{
  "capacityGib": NEW_CAPACITY
}

Where the following values must be specified:

• PROJECT_ID is your Google Cloud project ID.
• ZONE is the instance's Google Cloud zone.
• INSTANCE_NAME is the name of the Managed Lustre instance to update.
• updateMask=capacityGib specifies the field to update. A field will only be overwritten if it is in the mask.
• NEW_CAPACITY is the new storage capacity for this instance in gibibytes (GiB). The value cannot exceed the maximum allowed capacity and must be a multiple of the step size. See Calculate your new capacity for these values.

See the instances.patch API reference for more details.

Google Cloud console

1. Go to the Managed Lustre page in the Google Cloud console.

   Go to Managed Lustre

2. Click the instance name in the list. The Instance Details page appears, which includes the current status of your instance update request.

gcloud

By default, the gcloud lustre instances update command waits for completion before returning the shell prompt:

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

Once complete, the command line displays Updated instance [my-instance] along with the instance details, including the updated capacity.

If you ran the update command with the --async flag, or otherwise need to query the update status from the command line, you can retrieve the operation details to see if the instance has finished updating:

gcloud lustre operations describe OPERATION_ID \
  --location=ZONE

While the instance is updating, the response shows a done: false value. Once complete, done is set to true.

For example:

$ 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

To query the status of an update operation, use the operation ID from the response. The operation ID has the following format:

• operation-1234567890123-6127783ad26ea-88913969-02748053

Send a request to the following endpoint:

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

If successful, the response body contains an instance of Operation.