1. 接口描述
接口请求域名： turbofs.api3.gsesgpucloud.com。
本接口（CreateCfsRule）用于创建权限组规则。
默认接口请求频率限制：20次/秒。
接口更新时间：2024-02-28 15:13:53。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateCfsRule |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-04-16 |
| 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帐号权限。不填默认为no_root_squash。 示例值： |
| AuthClientIp | 是 | 否 | String | 允许访问的客户端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 | 操作不支持。 |