Get instance information

Google Cloud console

You can get information about your Filestore instances, and view all instances in a project, by going to the Filestore instances page:

Go to the Filestore instances page

gcloud

You can get information about your Filestore instances, and view all instances in a project, by running the instances list command:

 gcloud filestore instances list --project=project-id --zone=zone 

where:

• project-id is the project ID of the Google Cloud project that contains the Filestore instance. You can skip this flag if the Filestore instance is in the gcloud default project. You can set the default project by running:

   gcloud config set project project-id 

• zone is the zone for which you want to list Filestore instances. If you skip this flag, instances in all zones are returned. Run the gcloud filestore zones list command to get a list of supported zones.

The response to the instances list command is similar to the following:

 INSTANCE_NAME ZONE TIER CAPACITY_GB FILE_SHARE_NAME IP_ADDRESS STATE CREATE_TIME nfs-loc europe-west1-b BASIC_HDD 1024 nfs1 10.0.5.2 READY 2017-10-09T22:11:28 nfs3 us-central1-c BASIC_HDD 1024 acme 10.0.6.2 READY 2017-11-06T09:37:18 

Example

The following command lists the Filestore instances in project myproject:

 gcloud filestore instances list --project=myproject 

REST API

1. Have gcloud CLI installed and initialized, which lets you generate an access token for the Authorization header.

2. Use cURL to call the Filestore API:

   curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"

   Where:

   • PROJECT is the name of the project where your instance is located. For example, my-genomics-project.
   • LOCATION is the location you want to search. To search all instances in any location within a project, use -.

Google Cloud console

1. Go to the Filestore instances page.

   Go to the Filestore instances page

2. Click the instance ID to open the instance details page.

gcloud

Get information about a Filestore instance by running the instances describe command:

 gcloud filestore instances describe instance-id --project=project-id --location=location 

The response to the instances describe command is similar to the following:

 createTime: '2021-10-11T17:28:23.340943077Z' customPerformanceSupported: true fileShares: - capacityGb: '1024' name: vol1 kmsKeyName: projects/example-project/locations/us-central1/keyRings/example-ring/cryptoKeys/example-key labels: key:val name: projects/yourproject/locations/us-central1/instances/nfs-server networks: - ipAddresses: - 10.0.0.2 network: default reservedIpRange: 10.0.0.0/26 performanceConfig: iopsPerTb: maxIopsPerTb: '17000' performanceLimits: maxIops: '17000' maxReadIops: '17000' maxReadThroughputBps: '417792000' maxWriteIops: '5100' maxWriteThroughputBps: '139264000' state: READY tier: REGIONAL 

These fields represent the following values:

• createTime: The time the instance was created, in RFC 3339 format.
• fileShares:
• capacityGb: The size of the Filestore file share in binary gigabytes (GB), where 1 GB = 1024³ bytes.
• name: The name of the Filestore file share. You use the file share name with the IP address identified by the ipAddresses value to mount the file share on a client.
• name: The fully qualified name of the instance.
• ipAddresses: The IP address for the instance. To mount the Filestore file share on a client, use this value along with the file share name.
• network: The name of the VPC network that the instance uses.
• customPerformanceSupported: Indicates whether custom performance is supported for the instance. If not listed, custom performance is not supported.
• performanceConfig: The custom configuration for custom performance.
• performanceLimits: The enforced performance limits, calculated from the instance's performance.
• reservedIpRange: The IP address block reserved for the use of the instance.
• state: The state of the instance.
• tier: The Filestore service tier of the instance.

Example

The following command provides information about the test-nfs instance in project myproject, in region us-central1.

 gcloud filestore instances describe test-nfs --project=myproject --region=us-central1 

REST API

1. Have gcloud CLI installed and initialized, which lets you generate an access token for the Authorization header.

2. Use cURL to call the Filestore API:

   curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

   Where:

   • PROJECT is the name of the project where your instance is located. For example, my-genomics-project.
   • LOCATION is the location where your instance resides. For example, us-west1-a.
   • INSTANCE_NAME is the name of the instance you want to view. For example, my-genomics-instance.