Manage Google Cloud Managed Lustre instances

Once you've created an instance, Google Cloud Managed Lustre lets you list, get, update, and delete instances.

When updating Managed Lustre instances, only the description and labels can be modified.

List instances

To list all the instances in a project:

Google Cloud console

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

   Go to Managed Lustre

   Your project's instances are listed.

gcloud CLI

Use the gcloud lustre instances list command:

gcloud lustre instances list --location=LOCATION

Replace LOCATION with a specific zone to list all instances in that location. To view projects in all locations, enter - as the value. For example:

gcloud lustre instances list --location=-

REST

To list instances using the REST API, send a request to the following endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Where the following values must be specified:

• PROJECT_ID is your Google Cloud project ID.

• ZONE is the zone for which to list all instances. To list instances from all zones, use - as the value.

See the instances.list API reference for more details.

Get an instance

To get an instance's 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 to view details about a specific instance.

gcloud CLI

Use the gcloud lustre instances describe command:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

To get details about a particular instance using the REST API, send a request to the following endpoint:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Where the following values must be specified:

• PROJECT_ID is your Google Cloud project ID.

• ZONE must be a valid Google Cloud zone that is supported by Managed Lustre. See Supported locations for a full list.

• INSTANCE_NAME is the name of the Managed Lustre instance to return.

See the instances.get API reference for more details.

Update an instance

You can update the following properties of an existing instance:

• description
• labels
• storage capacity

For information about increasing an instance's storage capacity, see Increase the capacity of an instance.

To update an 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 value(s).

5. Click Submit.

Google Cloud CLI

Use the gcloud lustre instances update command:

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

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 Increase the capacity of an instance for more details.
• NEW_DESCRIPTION is a new value for the description field, which overwrites any existing description.

To update labels, see the available commands in the gcloud lustre instances update documentation.

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=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  }
}

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.
• UPDATE_MASK is a comma-separated list of fields to update. A field will only be overwritten if it is in the mask.

The request body must contain one or more of the following fields:

• capacityGiB 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 Increase the capacity of an instance for more details.
• description is the new description for this instance.
• labels is the new set of labels for this instance. The value of labels is a JSON object containing one or more key:value pairs.

See the instances.patch API reference for more details.

Delete an instance

To delete an instance:

Google Cloud console

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

   Go to Managed Lustre

2. Select the three-dot menu next to the instance to delete.

3. Select Delete instance. Confirm the deletion by clicking Delete again.

gcloud CLI

Use the gcloud lustre instances delete command:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

You are prompted to confirm deletion. Type Y or press enter to continue.

Tip: Specifying the --quiet or -q flag with the command skips the interactive confirmation requirement.

REST

To delete an instance using the REST API, send a request to the following endpoint:

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Where the following values must be specified:

• PROJECT_ID is your Google Cloud project ID.

• ZONE is the Google Cloud zone in which the instance is located.

• INSTANCE_NAME is the name of the Managed Lustre instance to delete.

See the instances.delete API reference for more details.

Delete requests are long-running requests, and return an operation ID that can be queried for operation status. See the operations.get reference for details.