接口功能介绍

查询租户指定vpc下的⽂件系统列表

接口约束

1.在2024年10月之后，弹性文件将支持VPCE终端节点服务接入，按资源池维度陆续上线，新建的文件系统默认支持VPCE。在弹性文件服务有关挂载地址的查询接口中将增加"vpceSharePath"字段，用于展示文件系统下每个VPC的挂载地址
· 原挂载地址相关字段无改动，云主机、容器用户无须适配新字段
· 若为物理机（标准裸金属）用户，须使用vpceSharePath字段中的挂载地址
· 该字段仅适用于可用区资源池，即使用资源池概况信息查询接口查询带对接的资源池信息，如资源池信息"regionVersion": "v4.0"，即可使用
2.自2024年11月15日起，本接口会受到IAM权限管控，当子账号或委托调用该接口时，需具备“sfs:fsInVpc:list”权限，否则会报权限不足的错误

URI

GET /v4/sfs/list-sfs-by-vpcid

路径参数
无

Query参数

请求参数

请求头header参数
无

请求体body参数
无

响应参数

表 returnObj

表 list1

表 list2

枚举参数

无

请求示例

请求url

GET https://sfs-global.ctapi.ctyun.cn/v4/sfs/list-sfs-by-vpcid?regionID=81f7728662dd11ec810800155d307d5b&vpcID=vpc-66jrjem533&pageSize=1&pageNo=2

请求头header

无

请求体body

无

响应示例

{
    "httpstatus": 200,
    "httpresult": {
        "returnObj": {
            "currentCount": 1,
            "totalCount": 7,
            "list": [
                {
                    "updateTime": 1704877131000,
                    "projectID": "0",
                    "usedSize": 34,
                    "kmsUUID": "",
                    "isEncrypt": false,
                    "sfsSize": 800,
                    "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": 1698230984000,
                    "sharePath": "100.100.128.101:/mnt/sfs_perf/b7565589f022439c1edefc7444166f7a_tsukev3k2hdvwu2v",
                    "mountCount": 0,
                    "sfsType": "performance",
                    "windowsSharePath": "",
                    "expireTime": 1703501445000,
                    "sfsProtocol": "nfs",
                    "azName": "az1",
                    "cephID": "r3egav3k2hdvwu2e",
                    "sfsUID": "f8bfd57d-26bf-5476-b1d3-406f3e7d119f",
                    "sharePathV6": "",
                    "sfsStatus": "available",
                    "windowsSharePathV6": null,
                    "sfsName": "sfs-test"
                }
            ],
            "pageSize": "1",
            "pageNo": "2"
        },
        "details": "",
        "message": "SUCCESS",
        "description": "成功",
        "statusCode": 800
    }
}

状态码

请参考 状态码

错误码

请参考 错误码