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

修改权限规则 - UpdatePermRule

功能介绍

修改权限规则。

接口约束

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

  • 该接口不适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。

调试

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

授权信息

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。

获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

share_id

是

String

参数解释:

文件系统ID,用于唯一标识SFS Turbo文件系统实例。

获取方法请参见查询文件系统列表接口。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

rule_id

是

String

参数解释:

权限规则ID,用于唯一标识文件系统中的某一条权限规则。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,用于鉴权认证。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

是

String

参数解释:

请求消息体MIME类型,用于标识请求正文的数据格式。

约束限制:

不涉及。

取值范围:

application/json

默认取值:

application/json

表3 请求Body参数

参数

是否必选

参数类型

描述

rw_type

否

String

参数解释:

授权对象的读写权限。

约束限制:

不涉及。

取值范围:

  • rw:读写,以读写方式共享文件系统。

  • ro:只读,以只读方式共享文件系统。

  • none:无权限。

默认取值:

rw

user_type

否

String

参数解释:

授权对象的系统用户对文件系统的访问权限,用于控制客户端用户在NFS服务端的身份映射方式。

约束限制:

不涉及。

取值范围:

  • no_root_squash:保留客户端用户身份。客户端使用包括root用户在内的任何用户访问时,NFS服务端保持客户端用户身份,不做映射。

  • root_squash:root用户映射为匿名用户。客户端使用root用户时,映射为NFS服务端的匿名用户(nfsnobody);客户端使用非root用户时,保持客户端用户身份,不做映射。

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

默认取值:

no_root_squash

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

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服务端的匿名用户。

状态码:400

表5 响应Body参数

参数

参数类型

描述

errCode

String

参数解释:

错误码,用于标识请求失败的原因。详细错误码请参见错误码。

取值范围:

不涉及。

errMsg

String

参数解释:

错误描述,用于描述请求失败的具体原因,便于排查问题。请参见错误码。

取值范围:

不涉及。

状态码:500

表6 响应Body参数

参数

参数类型

描述

errCode

String

参数解释:

错误码,用于标识请求失败的原因。详细错误码请参见错误码。

取值范围:

不涉及。

errMsg

String

参数解释:

错误描述,用于描述请求失败的具体原因,便于排查问题。请参见错误码。

取值范围:

不涉及。

请求示例

{
  "rw_type" : "rw",
  "user_type" : "no_root_squash"
}

响应示例

状态码:200

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

状态码:400

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "Invalid rule id"
}

状态码:500

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

状态码

状态码

描述

200

成功

400

错误响应

500

错误响应

错误码

请参见错误码。

相关文档