获取实例信息

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

准备工作

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

查看项目中的所有实例

Google Cloud 控制台

您可以获取有关 Filestore 实例的信息，并查看 访问 Filestore 实例，从而了解项目中的所有实例 页面：

转到“Filestore 实例”页面

gcloud

您可以获取有关 Filestore 实例的信息，并查看 项目中的所有实例，方法是运行 instances list 命令：

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

其中：

  • project-id 是执行上述操作的 Google Cloud 项目的 ID 包含 Filestore 实例。如果 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 标头生成访问令牌。

    或者，您可以使用 OAuth 2.0 Playground 创建访问令牌，并将其包含在 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 命令：

    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 标头生成访问令牌。

    或者，您可以使用 OAuth 2.0 Playground 创建访问令牌，并将其包含在 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

后续步骤