批量创建权限组规则

最近更新时间: 2026-09-17 00:03:25

1. 接口描述

接口请求域名： cfs.api3.fincloud.tencent.cn。

本接口（BatchAddCfsRules）用于批量创建权限组规则。

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

接口更新时间：2025-06-09 18:15:03。

接口既验签名又鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：BatchAddCfsRules
Version 是 否 String 公共参数，本接口取值：2019-07-19
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
PermissionGroupId 是 否 String 权限组 ID
示例值： pgroup-dbne3lnb
RuleList 是 否 Array of InputPermissionGroupRules 权限组规则列表
示例值：查看

3. 输出参数

参数名称 类型 描述
RuleList Array of PGroupRuleInfo 权限组规则列表
示例值：查看
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

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

5. 示例

示例1 批量创建权限组规则

批量创建权限组规则

输入示例

{
  "PermissionGroupId": "pgroup-m3bpht4h",
  "RuleList": [
    {
      "AuthClientIp": "192.108.11.1",
      "Priority": 1,
      "RWPermission": "rw",
      "UserPermission": "all_squash"
    },
    {
      "AuthClientIp": "192.108.11.2",
      "Priority": 1,
      "RWPermission": "ro",
      "UserPermission": "all_squash"
    }
  ]
}

输出示例

{
  "Response": {
    "RuleList": [
      {
        "AuthClientIp": "192.108.11.1",
        "Priority": 1,
        "RWPermission": "rw",
        "UserPermission": "all_squash",
        "RuleId": "rule-fdhlex79"
      },
      {
        "AuthClientIp": "192.108.11.2",
        "Priority": 1,
        "RWPermission": "ro",
        "UserPermission": "all_squash",
        "RuleId": "rule-nxddiecz"
      }
    ],
    "RequestId": "6a39a9ff-9b68-ff94-99ce-dcfa68ef1c62"
  }
}