接口功能介绍
根据文件系统sfsUID,查询指定文件系统挂载点列表
接口约束
1.当前接口使用前请使用资源池概况信息查询接口查询带对接的资源池信息,如资源池信息"regionVersion": "v3.0",即可使用;如资源池信息"regionVersion": "v4.0", 则不可使用
2.自2024年10月15日起,本接口会受到IAM权限管控,当子账号或委托调用该接口时,需具备“sfs:vpcs:list”权限,否则会报权限不足的错误
URI
GET /v4/sfs/list-mountpoint-sfs
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池 ID | 参考[请求示例] | |
sfsUID | 是 | String | 弹性文件功能系统唯一 ID | 参考[请求示例] | |
pageSize | 否 | Integer | 每页包含的数量 | 10 | |
pageNo | 否 | Integer | 当前页码 | 1 |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800 为成功,900 为失败) | 800 | |
message | String | 响应描述,一般为英文描述 | 参考[结果码] | |
description | String | 响应描述,一般为中文描述 | 参考[结果码] | |
returnObj | Object | 参考[returnObj] | returnObj | |
errorCode | String | 业务细分码,为 product.module.code 三段式码.参考[结果码] | 参考[结果码] | |
error | String | 业务细分码,为product.module.code三段式码大驼峰形式 | 参考[结果码] |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
mountPointList | String | 文件系统挂载点ID列表 | 参考[响应示例] | mountPointList |
currentCount | Integer | 当前查询到的文件系统挂载点ID个数 | 1 | |
totalCount | Integer | 资源池下文件系统挂载点ID总数 | 1 | |
pageSize | Integer | 每页个数 | 10 | |
pageNo | Integer | 当前页数 | 1 |
表 mountPointList
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
mountPointID | String | 挂载点ID | a59327e9-911e-549d-ba0d-25d3b5548d70 | |
subnetID | String | 子网ID | 11e51c6d-c82b-4917-8869-21d0647ec0b7 | |
vpcID | String | vpc ID | 03d40660-edaa-4132-94eb-a6436cf0ee36 | |
subnetName | String | 子网名字 | subnet-f496 | |
vpcName | String | vpc名字 | vpc-tzb02 |
枚举参数
无
请求示例
请求url
GET https://sfs-global.ctapi.ctyun.cn/v4/sfs/list-mountpoint-sfs?regionID=41f64827f25f468595ffa3a5deb5d15d&sfsUID=f0dffafd-8eb5-5285-9060-94e444886263&pageNo=1&pageSize=10
请求头header
无
请求体body
无
响应示例
{
"returnObj":{
"currentCount":1,
"mountPointList":[
{
"mountPointID":"07e39e43-2d94-5344-8fd9-29749e0310c9",
"subnetID": "11e51c6d-c82b-4917-8869-21d0647ec0b7",
"vpcID": "03d40660-edaa-4132-94eb-a6436cf0ee36",
"subnetName": "subnet-f496",
"vpcName": "vpc-tzb02"
}
],
"totalCount":1,
"pageNo":1,
"pageSize":10
},
"message":"SUCCESS",
"description":"成功",
"statusCode":800
}
状态码
请参考 状态码
错误码
请参考 错误码