更新时间：2026-09-30 GMT+08:00

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

功能介绍

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

接口约束

一个文件系统最多可以配置64条权限规则。
该接口仅适用于NFS文件系统共享协议。
该接口不适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
share_id	是	String	参数解释：文件系统ID，用于唯一标识SFS Turbo文件系统实例。获取方法请参见查询文件系统列表接口。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Long	参数解释：返回的权限规则个数，用于控制每页返回的规则数量。约束限制：不涉及。取值范围： 0~64的整数。默认取值：不涉及。
offset	否	Long	参数解释：返回的权限规则的偏移量，用于分页查询时指定起始位置。约束限制：不涉及。取值范围：大于等于0的整数。默认取值： 0

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token，用于鉴权认证。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
Content-Type	是	String	参数解释：请求消息体MIME类型，用于标识请求正文的数据格式。约束限制：不涉及。取值范围： application/json 默认取值： application/json

响应参数

状态码：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	参数解释：授权对象的系统用户对文件系统的访问权限，用于控制客户端用户在NFS服务端的身份映射方式。取值范围： no_root_squash：保留客户端用户身份。客户端使用包括root用户在内的任何用户访问时，NFS服务端保持客户端用户身份，不做映射。 root_squash：root用户映射为匿名用户。客户端使用root用户时，映射为NFS服务端的匿名用户（nfsnobody）；客户端使用非root用户时，保持客户端用户身份，不做映射。 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	错误响应

错误码

请参见错误码。

父主题： 权限管理