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 

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.

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 

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.

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 

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

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

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.

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.