文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 权限管理/ 查询文件系统的权限规则列表
更新时间:2024-11-13 GMT+08:00

查询文件系统的权限规则列表

功能介绍

查询文件系统的权限规则列表

URI

GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/perm-rules

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

share_id

String

文件系统id

表2 Query参数

参数

是否必选

参数类型

描述

limit

Long

返回的权限规则个数

offset

Long

返回的权限规则的偏移量

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

账号的token

Content-Type

String

MIME类型

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

rules

Array of OnePermRuleResponseInfo objects

权限信息

表5 OnePermRuleResponseInfo

参数

参数类型

描述

id

String

权限规格的id

ip_cidr

String

授权对象的IP地址或网段

rw_type

String

授权对象的读写权限

  • rw:默认选项,以读写的方式共享

  • ro:以只读的方式共享

  • none: 没有权限

user_type

String

授权对象的系统用户对文件系统的访问权限。取值如下:

  • no_root_squash:客户端使用的是root用户时,映射到NFS服务器的用户依然为root用户。

  • root_squash:客户端使用的是root用户时,映射到NFS服务器的用户为NFS的匿名用户(nfsnobody)。

  • all_squash:默认选项。所有访问NFS服务器的客户端的用户都映射为匿名用户。'

状态码: 500

表6 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde",查询该文件系统的权限规则列表

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/fs/perm-rules

响应示例

状态码: 200

查询成功

{
  "rules" : [ {
    "id" : "1131ed520xxxxxxebedb6e57xxxxxxxx",
    "ip_cidr" : "192.168.xx.xx/16",
    "rw_type" : "rw",
    "user_type" : "no_root_squash"
  }, {
    "id" : "1231ed520xxxxxxebedb6e57xxxxxxxx",
    "ip_cidr" : "192.32.xx.xx/16",
    "rw_type" : "rw",
    "user_type" : "no_root_squash"
  } ]
}

状态码: 500

错误响应

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

状态码

状态码

描述

200

查询成功

500

错误响应

错误码

请参见错误码