接口功能介绍

根据资源池 ID 查询指定存储类型的⽂件系统列表

接口约束

在2024年10月之后，弹性文件将支持VPCE终端节点服务接入，按资源池维度陆续上线，新建的文件系统默认支持VPCE。在弹性文件服务有关挂载地址的查询接口中将增加"vpceSharePath"字段，用于展示文件系统下每个VPC的挂载地址。

· 原挂载地址相关字段无改动，云主机、容器用户无须适配新字段。

· 若为物理机（标准裸金属）用户，须使用vpceSharePath字段中的挂载地址。

· 该字段仅适用于可用区资源池，即使用资源池概况信息查询接口查询带对接的资源池信息，如资源池信息"regionVersion": "v4.0"，即可使用。

URI

GET /v4/sfs/list-sfs-by-sfstype

路径参数
无

Query参数

请求参数

请求头header参数
无

请求体body参数
无

响应参数

表 returnObj

表 list1

表 list2

枚举参数

无

请求示例

请求url

GET https://sfs-global.ctapi.ctyun.cn/v4/sfs/list-sfs-by-sfstype?regionID=81f7728662dd11ec810800155d307d5b&sysType=performance&pageSize=1&pageNo=1

请求头header

无

请求体body

无

响应示例

{
  "returnObj": {
    "currentCount":1,
    "totalCount":1,
    "total": 1,
    "list": [
      {
        "updateTime": 1678342191000,
        "projectID": "0",
        "usedSize": 34,
         "phySharePath": "100.120.0.100:/mnt/sfs_perf/a7135589f022439c1edefc74b9336f7a_5czqobzhm0d4rjbx",
        "kmsUUID": "",
        "isEncrypt": false,
        "sfsSize": 1024,
        "vpceSharePath": [{"vpcID": "vpc-66jrjem533", "windowsSharePathV6": "", "windowsSharePath": "", "vpcName": "vpc-tzbtest", "sharePath": "192.168.0.7:/mnt/sfs_perf/a7135589f022439c1edefc74b9336f7a_8pq601rs3p8mmm6d", "sharePathV6": ""}],
        "onDemand": false,
        "regionID": "b73e3ad4-417f-11ed-bad1-525400cc3b79",
        "createTime": 1678239529000,
        "sharePath": "100.127.155.200:/mnt/sfs_perf/a7135589f022439c1edefc74b9336f7a_5czqobzhm0d4rjbx",
        "mountCount": 0,
        "sfsType": "performance",
        "windowsSharePath": "",
        "expireTime": 1709861929000,
        "sfsProtocol": "nfs",
        "azName": "az1",
        "cephID": "5czqobzhm0d4rjbx",
        "sfsUID": "73725123-0de1-5424-8115-7da2a24f3dfb",
        "sharePathV6": "",
        "sfsStatus": "available",
        "windowsSharePathV6": "",
        "sfsName": "yyx-sfs-test-003"
      }
    ],
    "pageSize": 1,
    "pageNo": 1
  },
  "message": "SUCCESS",
  "description": "成功",
  "statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码