为权限配置添加策略
最近更新时间: 2026-10-12 00:11:05
1. 接口描述
接口请求域名： cic.api3.fincloud.tencent.com。
为权限配置添加策略
默认接口请求频率限制：20次/秒。
接口更新时间：2024-12-11 12:17:58。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：AddPermissionPolicyToRoleConfiguration |
| Version | 是 | 否 | String | 公共参数，本接口取值：2021-03-31 |
| Region | 是 | 否 | String | 公共参数，地域信息本接口不需要传递此参数。 |
| CustomPolicyDocuments | 否 | 是 | Array of String | 自定义策略内容列表（跟RolePolicyNames一一对应） 示例值： {"statement":{"action":["name/cvm:","name/vpc:","name/cos:","name/cmqtopic:","name/cmqqueue:"],"effect":"allow","resource":""},"version":"2.0"} |
| ZoneId | 是 | 是 | String | 空间 ID 示例值： z-necd*** |
| RoleConfigurationId | 是 | 是 | String | 权限配置 ID 示例值： rc-so2msow |
| RolePolicyType | 是 | 是 | String | 权限策略类型。取值： System：系统策略。复用 CAM 的系统策略。 Custom: 自定义策略。按照 CAM 权限策略语法和结构编写的自定义策略。 示例值： System |
| RolePolicyNames | 否 | 是 | Array of String | 权限策略名称，长度最大为 20策略，每个策略长度最大32个字符。如果要添加系统策略，建议使用RolePolicies参数。自定义策略时，数组长度最大为1。 示例值： ["TestPolicy","Admin"] |
| RolePolicies | 否 | 是 | Array of PolicyDetail | 添加的系统策略详情。 示例值：查看 |
| CustomPolicyDocument | 否 | 是 | String | 自定义策略内容。长度：最大 4096 个字符。当RolePolicyType为Inline时，该参数必须配置。关于权限策略的语法和结构，请参见权限策略语法和结构。 示例值： [ "policyContent1", "policyContent2" ] |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameter.ParamError | |
| FailedOperation.DBOperationError | |
| FailedOperation.IdentityCenterNotOpen | |
| FailedOperation.ZoneIdNotExist | |
| InvalidParameter.RoleConfigurationNotExist | |
| InvalidParameter.PolicyNameAlreadyExists | |
| InvalidParameter.PolicyDocumentEmpty | |
| FailedOperation.SystemPolicyOverUpperLimit | |
| FailedOperation.CustomPolicyOverUpperLimit | |
| InvalidParameter.PolicyNameSizeOverUpperLimit | |
| InvalidParameter.BindPolicyNameNotAllowed |
5. 示例
示例1 为权限配置添加策略
输入示例
{
"ZoneId": "z-29wm2iwn",
"RoleConfigurationId": "rc-aiwmsiw",
"RolePolicyType": "System",
"RolePolicyNames": ["TestPolicy"],
"CustomPolicyDocument": "{\"statement\":{\"action\":[\"name/cvm:*\",\"name/vpc:*\",\"name/cos:*\",\"name/cmqtopic:*\",\"name/cmqqueue:*\"],\"effect\":\"allow\",\"resource\":\"*\"},\"version\":\"2.0\"}"
}
输出示例
{
"Response": {
"RequestId": "e297543a-80de-4039-83c8-9d324545"
}
}