文档首页/ 弹性文件服务 SFS/ API参考/ SFS Turbo API说明/ 权限管理/ 创建权限规则
更新时间：2025-07-22 GMT+08:00
查看PDF
分享

创建权限规则

功能介绍

创建权限规则

接口约束

一个文件系统最多可以配置64条权限规则。

该接口仅适用于NFS文件系统共享协议。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型
表3 请求Body参数

参数

是否必选

参数类型

描述

rules

是

Array of OnePermRuleRequestInfo objects

权限信息，一次最多允许添加5条规则
表4 OnePermRuleRequestInfo

参数

是否必选

参数类型

描述

ip_cidr

是

String

授权对象的IP地址或网段，设置后不支持修改

rw_type

是

String

授权对象的读写权限

  • rw：默认选项，以读写的方式共享

  • ro：以只读的方式共享

  • none: 没有权限

user_type

是

String

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

  • no_root_squash：默认选项。客户端使用包括root用户在内的任何用户，NFS服务器都保持客户端使用的用户，不做映射。

  • root_squash：客户端使用的是root用户时，映射到NFS服务器的用户为NFS的匿名用户（nfsnobody）。客户端使用非root用户时，NFS服务器保持客户端使用的用户，不做映射。

  • all_squash：所有访问NFS服务器的客户端的用户都映射为匿名用户。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

rules

Array of OnePermRuleResponseInfo objects

权限规格信息
表6 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服务器的客户端的用户都映射为匿名用户。'

状态码：400

表7 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：500

表8 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

  • 创建权限规则的请求示例。

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

响应示例

状态码：200

创建成功

  • 创建权限规则的响应示例。

    {
  "rules" : [ {
    "id" : "1131ed520xxxxxxebedb6e57xxxxxxxx",
    "ip_cidr" : "192.32.0.0/16",
    "rw_type" : "rw",
    "user_type" : "no_root_squash"
  }, {
    "id" : "1131ed520xxxxxxebedb6e57xxxxxxxx",
    "ip_cidr" : "192.32.0.1",
    "rw_type" : "rw",
    "user_type" : "no_root_squash"
  } ]
}

状态码：400

错误响应

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "Rules not allowed empty"
}

状态码：500

错误响应

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

状态码

状态码

描述

200

创建成功

400

错误响应

500

错误响应

错误码

请参见错误码。

父主题： 权限管理