本页面介绍如何获取 Filestore 实例的相关信息。
准备工作
如果您要使用本页面中的命令行示例,请通过安装 gcloud CLI 来启用 gcloud 命令行工具。
查看项目中的所有实例
Google Cloud 控制台
您可以前往“Filestore 实例”页面,获取 Filestore 实例的相关信息,并查看项目中的所有实例:
gcloud
您可以通过运行 instances list 命令来获取 Filestore 实例的相关信息,以及查看项目中的所有实例:
  gcloud filestore instances list --project=project-id --zone=zone
其中:
- project-id 是包含 Filestore 实例的 Google Cloud 项目的项目 ID。如果 Filestore 实例位于 - gcloud默认项目中,则可以跳过此标志。您可以通过运行以下命令来设置默认项目:- gcloud config set project project-id
- zone 是要为其列出 Filestore 实例的可用区。如果省略此标志,则系统将返回所有区域中的实例。运行 - gcloud filestore zones list命令以获取受支持区域的列表。
对 instances list 命令的响应如下所示:
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
示例
以下命令列出了项目 myproject 中的 Filestore 实例:
  gcloud filestore instances list --project=myproject
REST API
- 安装并初始化 gcloud CLI,以便为 - Authorization标头生成访问令牌。
- 使用 - cURL调用 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" - 其中: - PROJECT是实例所在的项目的名称。例如- my-genomics-project。
- LOCATION是您要搜索的地点。如需搜索项目中任何位置的所有实例,请使用- -。
 
获取有关特定实例的信息
使用以下一个过程获取有关特定 Filestore 实例的信息。
Google Cloud 控制台
- 转到“Filestore 实例”页面 
- 点击实例 ID 以打开“实例详情”页面。 
gcloud
通过运行 instances describe 命令获取有关 Filestore 实例的信息:
    gcloud filestore instances describe instance-id --project=project-id --location=location
对 instances describe 命令的响应如下所示:
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
这些字段表示以下值:
- createTime:实例的创建时间,采用 RFC 3339 格式。
- fileShares:
- capacityGb:Filestore 文件共享的大小,以二进制千兆字节 (- GB) 为单位,其中 1- GB= 10243 字节。
- name:Filestore 文件共享的名称。使用文件共享名称与- ipAddresses值标识的 IP 地址来将文件共享装载到客户端上。
- name:实例的完全限定名称。
- ipAddresses:实例的 IP 地址。如需在客户端上装载 Filestore 文件共享,请使用此值以及文件共享名称。
- network:实例使用的 VPC 网络的名称。
- customPerformanceSupported:指示实例是否支持自定义性能。如果未列出,则表示不支持自定义性能。
- performanceConfig:自定义效果的自定义配置。
- performanceLimits:强制执行的性能限制,根据实例的性能计算得出。
- reservedIpRange:保留供实例使用的 IP 地址块。
- state:实例的状态。
- tier:实例的 Filestore 服务层级。
示例
以下命令提供有关位于区域 us-central1 的项目 myproject 中的 test-nfs 实例的信息。
gcloud filestore instances describe test-nfs --project=myproject --region=us-central1
REST API
- 安装并初始化 gcloud CLI,以便为 - Authorization标头生成访问令牌。
- 使用 - cURL调用 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" - 其中: - PROJECT是实例所在的项目的名称。例如- my-genomics-project。
- LOCATION是实例所在的位置。例如- us-west1-a。
- INSTANCE_NAME是您要查看的实例的名称。例如- my-genomics-instance。
 
获取有关 Filestore 实例挂载的信息
以下部分介绍了如何获取不同类型的实例挂载信息。
列出实例的装载点
您可以通过运行以下命令来列出装载 Filestore 实例的所有装载点:
    sudo showmount -a INSTANCE_IP
示例
以下命令列出了 IP 地址为 10.77.67.226 的 Filestore 实例的所有装载点:
    sudo showmount -a 10.77.67.226
响应类似于以下内容:
All mount points on 10.77.67.226:
10.128.0.1:/fileshare
10.128.0.2:/fileshare
10.128.0.3:/fileshare
获取实例的装载点数量
您可以通过运行以下命令来获取 Filestore 实例的装载点总数:
    sudo showmount -a INSTANCE_IP --no-headers | wc -l
示例
以下命令会显示 IP 地址为 10.77.67.226 的实例的装载点数量:
    sudo showmount -a 10.77.67.226 --no-headers | wc -l