错误码
最近更新时间:2023-08-25 16:52:13
功能说明
返回结果中的错误码表示了用户调用云 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 字段错误 |
请参考文档中 principal 字段的描述 |
4000 |
InvalidParameter.action.Error |
策略语法中 action 字段错误 |
请参考文档中 action 字段的描述 |
4000 |
InvalidParameter.effect.Error |
策略语法中 effect 字段错误 |
请参考文档中 effect 字段的描述 |
4000 |
MissingParameter.action |
策略语法缺少 action 字段 |
请在策略语法中添加 action 字段 |
4000 |
InvalidParameter.policyName.TypeError |
策略名类型错误,策略名必须是字符串 |
请将策略名修改为字符串类型 |
4000 |
InvalidParameter.policyName.Error |
策略名包含非法字符或长度超过限制,策略名最大长度是128个字节,策略名字符只能是字母、数字或特殊字符+=,.@_- |
请按照说明调整策略内容 |
4000 |
InvalidParameter.policyDocument.TypeError |
策略语法类型错误 |
请将策略名修改为字符串类型 |
4000 |
MissingParameter.version |
策略语法缺少 version 字段 |
请填入 version 参数 |
4000 |
InvalidParameter.version.Error |
策略语法 version 字段错误 |
请检查策略语法中的 version 格式是否正确 |
4000 |
MissingParameter.statement |
策略语法缺少 statement 字段 |
请填入 statement 参数 |
4000 |
InvalidParameter.statement.Error |
策略语法 statement 字段错误 |
请检查策略语法中的 statement 格式是否正确 |
4000 |
InvalidParameter.policyDocument.LengthOverlimit |
策略语法长度超过限制,限制大小是4096个字节 |
请减少策略描述长度,策略内容过多时可拆分为多条策略 |
4000 |
InvalidParameter.condition.Error |
策略语法 condition 字段错误 |
请检查策略语法中的 condition 是否正确 |
4000 |
MissingParameter.resource |
策略语法缺少 resource 字段 |
请填入 resource 参数 |
4000 |
InvalidParameter.resource.Error |
策略语法 resource 字段错误 |
请检查策略语法中的 resource 格式是否正确 |
4000 |
InvalidParameter.resource.user.Error |
策略语法的 resource 不是自己账户的资源 |
请将策略语法中的 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 信息 |