功能说明
返回结果中的错误码表示了用户调用云 API 的结果。
code 为公共错误码,其适用于所有模块的 API 接口。code 为0,表示调用成功,否则表示调用失败。若调用失败,用户可以根据公共错误码列表确定错误原因并采取相应措施。
codeDesc 为模块错误码,表示与模块相关的错误。若调用失败,用户可以根据模块错误码列表确定错误原因并采取相应措施。
错误码列表
公共错误码
错误代码 | 错误类型 | 处理措施 |
4000 | 请求参数非法 | 缺少必要参数,或者参数值格式不正确,具体错误信息请查看错误描述 message 字段。 |
4100 | 鉴权失败 | 签名鉴权失败。 |
4200 | 请求过期 | 请求已经过期。 |
4300 | 拒绝访问 | 账号被封禁,或者不在接口针对的用户范围内等。 |
4400 | 超过配额 | |
4500 | 重放攻击 | 请求的 Nonce 和 Timestamp 参数用于确保每次请求只会在服务器端被执行一次,所以本次的 Nonce 和上次的不能重复,Timestamp 与腾讯服务器相差不能超过2小时。 |
4600 | 协议不支持 | 协议不支持。 |
5100 | 生成凭证错误 | 接口生成凭证错误,属于后端服务错误。 |
模块错误码
错误码 | 模块错误码(codeDesc) | 说明 | 处理措施 |
4000 | InvalidParameter.policyName.InUse | 策略名已存在,CAM 要求同一个账户下的策略名不能重复 | 请使用新的策略名 |
4000 | InvalidParameter | 无效入参 | 请参考返回的 error message,检查对应的参数 |
5100 | InternalError | 内部系统错误 | - |
4000 | InvalidParameter.AttachmentFull | 用户/用户组/角色绑定的策略数达到上限,附加到 1 个用户/用户组/角色的最大策略数是200,继续绑定将会失败 | 请解绑旧的策略 |
4000 | InvalidParameter.principal.Error | 策略语法中 principal 字段错误 | |
4000 | InvalidParameter.action.Error | 策略语法中 action 字段错误 | |
4000 | InvalidParameter.effect.Error | 策略语法中 effect 字段错误 | 请参考文档中 effect 字段的描述 |
4000 | MissingParameter.action | 策略语法缺少 action 字段 | |
4000 | InvalidParameter.policyName.TypeError | 策略名类型错误,策略名必须是字符串 | 请将策略名修改为字符串类型 |
4000 | InvalidParameter.policyName.Error | 策略名包含非法字符或长度超过限制,策略名最大长度是128个字节,策略名字符只能是字母、数字或特殊字符 +=,.@_- | 请按照说明调整策略内容 |
4000 | InvalidParameter.policyDocument.TypeError | 策略语法类型错误 | 请将策略名修改为字符串类型 |
4000 | MissingParameter.version | 策略语法缺少 version 字段 | |
4000 | InvalidParameter.version.Error | 策略语法 version 字段错误 | |
4000 | MissingParameter.statement | 策略语法缺少 statement 字段 | |
4000 | InvalidParameter.statement.Error | 策略语法 statement 字段错误 | |
4000 | InvalidParameter.policyDocument.LengthOverlimit | 策略语法长度超过限制,限制大小是4096个字节 | 请减少策略描述长度,策略内容过多时可拆分为多条策略 |
4000 | InvalidParameter.condition.Error | 策略语法 condition 字段错误 | |
4000 | MissingParameter.resource | 策略语法缺少 resource 字段 | |
4000 | InvalidParameter.resource.Error | 策略语法 resource 字段错误 | |
4000 | InvalidParameter.resource.user.Error | 策略语法的 resource 不是自己账户的资源 | |
4000 | InvalidParameter.description.LengthOverlimit | 策略描述长度超出限制,限制大小是300个字节 | 请减少策略描述长度 |
4000 | MissingParameter.policyName | 缺少 policyName 入参 | 请填入 policyName 参数 |
4000 | MissingParameter.policyDocument | 缺少 policyDocument 入参 | 请填入 policyDocument 参数 |
4000 | InvalidParameter.description.TypeError | 策略描述类型错误,策略描述必须是字符串 | 请检查策略描述类型 |
4000 | InvalidParameter.policyId.NotExist | 策略 ID 不存在 | 请使用正确的策略 ID |
4000 | MissingParameter.policyId | 缺少 policyId 入参 | 请填入 policyId 参数 |
4000 | InvalidParameter.policyId.TypeError | 策略 ID 类型错误,策略 ID 必须是数字 | 请检查策略 ID 类型 |
4000 | InvalidParameter.policyFull | 该账户下拥有的策略数达到上限,上限是1000 | 请删除无用的策略 |
4000 | InvalidParameter.user.NotExist | 用户不存在,或策略语法 principal 字段的用户不存在 | 请检查对应的用户是否存在 |
4000 | InvalidParameter.group.NotExist | 用户组不存在,或策略语法 principal 字段的用户组不存在 | 请检查对应的用户组是否存在 |
4000 | InvalidParameter.role.NotExist | 角色不存在 | 请创建对应的角色 |
4000 | InvalidParameter.roleName.TypeError | 角色名类型错误,角色名必须是字符串 | 请按照说明检查角色名类型是否合法 |
4000 | InvalidParameter.roleName.Error | 角色名包含非法字符或长度超过限制,角色名最大长度是128个字节,策略名字符只能是字母、数字或 +=,.@_- | 请按照说明检查角色名是否合法 |
4000 | InvalidParameter.roleFull | 该账户拥有的角色数量达到上限,一个账户最多拥有250个角色 | 请删除无用的角色 |
4000 | InvalidParameter.roleName.InUse | 角色名已存在,同一个账户下角色名不能重复 | 请使用新的角色名或删除已存在的同名角色 |
4000 | CanNotGetOwnerUin | 无法获取用户 OwnerUin | 请确认账号是否有误 |
4000 | GetAppIdError | 无法获取用户 AppId | 请确认账号是否有误 |
4000 | SetTimeOutOfTime | 用户设置临时凭证有效期超过最大时限 | 请参考具体接口的参数说明 |
4000 | StrategyInvalid | 获取联合身份临时证书设置策略信息错误 | 请参考 message 信息 |