获取实例信息

本页面介绍如何获取 Filestore 实例的相关信息。

准备工作

如果您要使用本页面中的命令行示例，请通过安装 gcloud CLI 来启用 gcloud 命令行工具。

查看项目中的所有实例

Google Cloud 控制台

您可以前往“Filestore 实例”页面，获取 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

  1. 安装并初始化 gcloud CLI，以便为 Authorization 标头生成访问令牌。

  2. 使用 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 控制台

  1. 转到“Filestore 实例”页面

    转到“Filestore 实例”页面

  2. 点击实例 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

  1. 安装并初始化 gcloud CLI，以便为 Authorization 标头生成访问令牌。

  2. 使用 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

后续步骤