获取实例信息

本页面介绍如何获取 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'
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-c/instances/nfs-server
networks:
- ipAddresses:
 - 10.0.0.2
 network: default
 reservedIpRange: 10.0.0.0/26
state: READY
tier: ENTERPRISE

这些字段表示以下值:

  • createTime:实例的创建时间,采用 RFC 3339 格式。
  • fileShares
  • capacityGb:Filestore 文件共享的大小,以二进制千兆字节 (GB) 为单位,其中 1 GB = 10243 字节。
  • name:Filestore 文件共享的名称。使用文件共享名称与 ipAddresses 值标识的 IP 地址来将文件共享装载到客户端上。
  • name:实例的完全限定名称。
  • ipAddresses:实例的 IP 地址。如需在客户端上装载 Filestore 文件共享,请使用此值以及文件共享名称。
  • network:实例使用的 VPC 网络的名称。
  • reservedIpRange:保留供实例使用的 IP 地址块。
  • state:实例的状态。
  • tier:实例的 Filestore 服务层级。

示例

以下命令提供有关位于区域 us-central1-c 的项目 myproject 中的 test-nfs 实例的信息。

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

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

后续步骤