Editing Instances

Use this topic to learn how to update a Cloud Filestore instance by using either the Google Cloud Platform console or the gcloud command-line tool.

You can update a Cloud Filestore instance by increasing the instance size, or changing the instance description.

You can also modify an instance by adding, removing, or changing labels. For more information, see Managing Labels.

Before you begin

If you want to use the command-line examples in this topic, enable the gcloud command-line tool by installing the Cloud SDK.

Editing an instance

Console

  1. Go to the Cloud Filestore instances page
  2. Click the instance ID of the instance you want to edit.
  3. On the Instance details page, click Edit.
  4. For Description, optionally modify the instance description.
  5. For Fileshare capacity, optionally modify the instance's fileshare capacity.
  6. Click Save.

gcloud

Edit an instance by running the instances update command, replacing [VALUES_IN_BRACKETS] with the appropriate values:

gcloud filestore instances update [INSTANCE_ID] 
--project=[PROJECT_ID]
--location=[LOCATION]
--file-share=name="[FILESHARE_NAME]",capacity=[FILESHARE_SIZE]
--description="[INSTANCE_DESCRIPTION]"

where the parameters are as follows:

  • [INSTANCE_ID] is the identifier for the instance you want to edit.
  • [PROJECT_ID] is the ID of the GCP project that contains the instance. You can skip this flag if you have set the gcloud default project and want to use that.
  • [LOCATION] is the GCP zone in which the GCP project instance resides. Run the gcloud filestore locations list command to get a list of supported locations. You can skip this flag if you have set the gcloud default location by running the gcloud config set filestore/location command.
  • [FILESHARE_NAME] is the name of the NFS fileshare that is served from the GCP project instance.
  • [FILESHARE_SIZE] is the new size you want for the fileshare. You can only increase the size of an instance, not decrease it. The maximum fileshare size is 63.9 TB. To see your available quota, go to the Quotas page. You can specify the fileshare size in whole numbers using either gigabytes or terabytes. The default unit is gigabytes.
  • [INSTANCE_DESCRIPTION] is the optional Cloud Filestore instance description.

Example

The following example updates the nfs-server instance by increasing the fileshare size to 3 TB.

gcloud filestore instances update nfs-server 
--project=myproject
--location=us-central1-c
--file-share=name="vol1",capacity=3TB

What's next

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Filestore Documentation