错误码

最近更新时间: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 信息