Console
    Contact Us Start free

    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 Lustrepage 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 alllocations, 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 
  
 h 
 tt 
 ps 
 : 
 //lustre.googleapis.com/v1/projects/ PROJECT_ID 
/locations/ ZONE 
/instances 
 Au 
 t 
 horiza 
 t 
 io 
 n 
 : 
  
 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 Lustrepage 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 
  
 h 
 tt 
 ps 
 : 
 //lustre.googleapis.com/v1/projects/ PROJECT_ID 
/locations/ ZONE 
/instances/ INSTANCE_NAME 
 
 Au 
 t 
 horiza 
 t 
 io 
 n 
 : 
  
 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 Lustrepage in the Google Cloud console.

      Go to Managed Lustre

    2. Click the Instance nameof 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 
  
 h 
 tt 
 ps 
 : 
 //lustre.googleapis.com/v1/projects/ PROJECT_ID 
/locations/ ZONE 
/instances/ INSTANCE_NAME 
?updateMask= UPDATE_MASK 
 
 Au 
 t 
 horiza 
 t 
 io 
 n 
 : 
  
 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 Lustrepage 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 Deleteagain.

    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.

    REST

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

      DELETE 
  
 h 
 tt 
 ps 
 : 
 //lustre.googleapis.com/v1/projects/ PROJECT_ID 
/locations/ ZONE 
/instances/ INSTANCE_NAME 
 
 Au 
 t 
 horiza 
 t 
 io 
 n 
 : 
  
 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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: