接口功能介绍

根据资源池 ID 和 弹性文件的sfsUID，查询文件系统信息

接口约束

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

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

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

· 该字段仅适用于可用区资源池，即使用资源池概况信息查询接口查询带对接的资源池信息，如资源池信息"regionVersion": "v4.0"，即可使用
2.自2024年10月15日起，本接口会受到IAM权限管控，当子账号或委托调用该接口时，需具备“sfs:shares:get”权限，否则会报权限不足的错误

URI

GET /v4/sfs/info-sfs

路径参数
无

Query参数

请求参数

请求头header参数
无

请求体body参数
无

响应参数

表 returnObj

表 list1

枚举参数

无

请求示例

请求url

GET https://sfs-global.ctapi.ctyun.cn/v4/sfs/info-sfs?regionID=81f7728662dd11ec810800155d307d5b&sfsUID=73725123-0de1-5424-8115-7da2a24f3dfb

请求头header

无

请求体body

无

响应示例

{
  "returnObj":{
    "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/4c7e60035aafeb9f66f9ea9f8b98e5fb_vo12l2ks9zhr4g5f", "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"
  },
  "message":"SUCCESS",
  "description":"成功",
  "statusCode":800
}

状态码

请参考 状态码

错误码

请参考 错误码