文件存储（CFS）

租户端存储文件存储（CFS）权限组相关接口 CreateCfsRule

CreateCfsRule

最近更新时间: 2025-03-12 16:34:38

1. 接口描述

接口请求域名： cfs.api3.gds-cloud.com。

本接口（CreateCfsRule）用于创建权限组规则。

默认接口请求频率限制：20次/秒。

接口更新时间：2019-09-20 16:38:18。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：CreateCfsRule
Version	是	否	String	公共参数，本接口取值：2019-07-19
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
PGroupId	是	否	String	权限组 ID 示例值：
RWPermission	否	否	String	读写权限, 值为 RO、RW；其中 RO 为只读，RW 为读写，不填默认为只读示例值：
UserPermission	否	否	String	用户权限，值为 all_squash、no_all_squash、root_squash、no_root_squash。其中all_squash为所有访问用户都会被映射为匿名用户或用户组；no_all_squash为访问用户会先与本机用户匹配，匹配失败后再映射为匿名用户或用户组；root_squash为将来访的root用户映射为匿名用户或用户组；no_root_squash为来访的root用户保持root帐号权限。不填默认为root_squash。示例值：
AuthClientIp	是	否	String	可以填写单个 IP 或者单个网段，例如 10.1.10.11 或者 10.10.1.0/24。默认来访地址为*表示允许所有。同时需要注意，此处需填写 CVM 的内网 IP。示例值：
Priority	是	否	Int64	规则优先级，参数范围1-100。其中 1 为最高，100为最低示例值：

3. 输出参数

参数名称	类型	描述
RuleId	String	规则 ID 示例值：
PGroupId	String	权限组 ID 示例值：
AuthClientIp	String	客户端 IP 示例值：
RWPermission	String	读写权限示例值：
UserPermission	String	用户权限示例值：
Priority	Int64	优先级示例值：
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameter	参数错误。
InternalError	内部错误。
InternalError.GetAccountStatusFailed	获取用户费用状态失败。
FailedOperation.PgroupInUse	权限组已绑定文件系统。
InvalidParameterValue.DuplicatedRuleAuthClientIp	规则IP重复。
InvalidParameterValue.InvalidAuthClientIp	规则IP错误。
InvalidParameterValue.InvalidPgroup	权限组不属于该用户。
InvalidParameterValue.InvalidPriority	优先级设置错误。
InvalidParameterValue.InvalidRwPermission	读写权限设置错误。
InvalidParameterValue.InvalidUserPermission	用户权限设置错误。
ResourceInsufficient.RuleLimitExceeded	规则条数超过上限。
ResourceNotFound.PgroupNotFound	权限组不存在。
FailedOperation	操作失败。
UnsupportedOperation	操作不支持。
FailedOperation.PgroupIsUpdating	权限组正在更新中。
UnsupportedOperation.UnverifiedUser	用户未经过实名认证。
UnsupportedOperation.OutOfService	用户已欠费, 请充值后重试。