帮你快速理解、总结文档立即下载

错误码

最近更新时间:2026-08-24 21:39:48
我的收藏

功能说明

如果返回结果中存在 Error 字段,则表示调用 API 接口失败。例如:

 {
    "Response": {
        "Error": {
            "Code": "AuthFailure.SignatureFailure",
            "Message": "The provided credentials could not be validated. Please check your signature is correct."
        },
        "RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
    }
}

Error 中的 Code 表示错误码,Message 表示该错误的具体信息。

错误码列表

公共错误码

错误码 说明
ActionOffline 接口已下线。
AuthFailure.InvalidAuthorization 请求头部的 Authorization 不符合腾讯云标准。
AuthFailure.InvalidSecretId 密钥非法(不是云 API 密钥类型)。
AuthFailure.MFAFailure MFA 错误。
AuthFailure.SecretIdNotFound 密钥不存在。请在 控制台 检查密钥是否已被删除或者禁用,如状态正常,请检查密钥是否填写正确,注意前后不得有空格。
AuthFailure.SignatureExpire 签名过期。Timestamp 和服务器时间相差不得超过五分钟,请检查本地时间是否和标准时间同步。
AuthFailure.SignatureFailure 签名错误。签名计算错误,请对照调用方式中的签名方法文档检查签名计算过程。
AuthFailure.TokenFailure token 错误。
AuthFailure.UnauthorizedOperation 请求未授权。请参考 CAM 文档对鉴权的说明。
DryRunOperation DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。
FailedOperation 操作失败。
InternalError 内部错误。
InvalidAction 接口不存在。
InvalidParameter 参数错误(包括参数格式、类型等错误)。
InvalidParameterValue 参数取值错误。
InvalidRequest 请求 body 的 multipart 格式错误。
IpInBlacklist IP 地址在黑名单中。
IpNotInWhitelist IP 地址不在白名单中。
LimitExceeded 超过配额限制。
MissingParameter 缺少参数。
NoSuchProduct 产品不存在
NoSuchVersion 接口版本不存在。
RequestLimitExceeded 请求的次数超过了频率限制。
RequestLimitExceeded.GlobalRegionUinLimitExceeded 主账号超过频率限制。
RequestLimitExceeded.IPLimitExceeded IP 限频。
RequestLimitExceeded.UinLimitExceeded 主账号限频。
RequestSizeLimitExceeded 请求包超过限制大小。
ResourceInUse 资源被占用。
ResourceInsufficient 资源不足。
ResourceNotFound 资源不存在。
ResourceUnavailable 资源不可用。
ResponseSizeLimitExceeded 返回包超过限制大小。
ServiceUnavailable 当前服务暂时不可用。
UnauthorizedOperation 未授权操作。
UnknownParameter 未知参数错误,用户多传未定义的参数会导致错误。
UnsupportedOperation 操作不支持。
UnsupportedProtocol http(s) 请求协议错误,只支持 GET 和 POST 请求。
UnsupportedRegion 接口不支持所传地域。

业务错误码

错误码 说明
InternalError.ComponentError 第三方组件错误
InternalError.CosConnectivityError COS 桶连通性检测失败
InternalError.CosError COS 相关操作失败
InternalError.CvmQueryFailed 查询CVM实例信息失败,请稍后重试
InternalError.InitRepositoryFailed 初始化备份库失败,请稍后重试
InternalError.PartialDeleteFailed 部分备份点删除失败,请稍后重试
InternalError.SnapshotTreeQueryFailed 查询备份内容失败,请稍后重试
InternalError.TradeError 计费系统调用失败,请稍后重试
InvalidFilter 无效的过滤器
InvalidParameter.DiskSizeNotMatch 大小不匹配
InvalidParameter.Invalid 参数不合法
InvalidParameter.InvalidFilter 过滤参数非法
InvalidParameter.InvalidParameter 参数错误
InvalidParameter.InvalidValue 参数错误
InvalidParameter.MissingField 至少需要提供一个要修改的字段
InvalidParameter.MissingParameter 参数缺失
InvalidParameter.ParameterError 参数错误
InvalidParameter.PathNested 备份路径存在嵌套关系,请确保路径之间无父子目录包含关系
InvalidParameter.PolicyNotSupportVault 备份策略不支持备份库模式
InvalidParameter.PolicyTypeMismatch 指定的策略不是文件备份策略,请选择正确的策略类型
InvalidParameter.PolicyVaultConflict 策略已绑定其他备份库,无法使用不同的备份库
InvalidParameter.ShouldConvertBackupToImage 盘与备份格式不匹配
InvalidParameterValue.CvmInstanceNotExist CVM实例不存在,请确认实例ID是否正确
InvalidParameterValue.InvalidConflictStrategy 冲突处理策略参数无效
InvalidParameterValue.InvalidFormat 无效参数值。参数值格式错误或者参数值不被支持等
InvalidParameterValue.InvalidInstanceId 网关实例ID格式错误
InvalidParameterValue.InvalidOrderDirection 排序方向无效,仅支持asc或desc
InvalidParameterValue.InvalidOrderField 排序字段无效,当前仅支持按name排序
InvalidParameterValue.InvalidProgress 进度值超出有效范围[0.00-100.00]
InvalidParameterValue.InvalidStatusTransition 作业状态转换无效,例如从终态转换到其他状态
InvalidParameterValue.InvalidValue 参数值非法
InvalidParameterValue.LimitExceeded 不合法的参数值,超过限制
InvalidParameterValue.PathTooLong 恢复路径列表中存在超过系统长度限制的路径
InvalidParameterValue.PolicyNotAvailable 备份策略不存在或不可绑定
InvalidParameterValue.VaultStateError 备份库当前状态不可写,请检查备份库是否正常
MissingParameter.MissingRequired 必填参数缺失
ResourceInUse.DiskRollbacking 资源回滚中
ResourceInUse.ResourceBusy 资源繁忙
ResourceNotFound.AgentNotInstalled 指定实例未找到对应的Agent,请确认Agent是否已安装
ResourceNotFound.AutoBackupPolicyNotFound 定期备份策略不存在
ResourceNotFound.BackupPlanNotExist 指定的备份计划不存在
ResourceNotFound.CopyPairNotExist 复制对不存在
ResourceNotFound.DisasterRecoveryProtectGroupNotExist 保护组不存在
ResourceNotFound.DisasterRecoverySitePairNotExist 站点对ID不存在
ResourceNotFound.DrillNotExist 演练不存在
ResourceNotFound.FileBackupNotExist 指定的备份点不存在,请确认备份点ID是否正确
ResourceNotFound.Gateway 指定的网关不存在或未注册
ResourceNotFound.InstanceNotExist 实例不存在
ResourceNotFound.Job 指定的作业不存在
ResourceNotFound.NotFound 资源不存在
ResourceNotFound.SourceCVMNotFound 源端云服务器不存在
ResourceNotFound.VaultNotExist 备份库不存在
ResourceNotFound.VpcMappingNotExist VPC映射不存在
ResourceUnavailable.BackupCreating 资源正在创建备份
ResourceUnavailable.NotSupportInCurrentSide 当前端不支持此操作
ResourceUnavailable.NotSupported 资源不支持当前操作
ResourceUnavailable.SnapshotCreating 云硬盘正在创建快照,请稍后重试
ResourcesSoldOut 资源售罄。
UnauthorizedOperation.HasNoStrategy 未授权操作
UnauthorizedOperation.LackOfQualification 用户资质不满足要求,无法创建备份资源
UnauthorizedOperation.MFAExpired MFA认证过期
UnsupportedOperation.AgentNotActive Agent当前状态不是活跃状态,无法创建备份
UnsupportedOperation.BackupGroupDiskAttachMultiInstance 盘挂载在不同子机上
UnsupportedOperation.CopyPairStateError 复制对当前状态不支持该操作
UnsupportedOperation.DisasterRecoveryProtectGroupBindResource 容灾保护组已绑定资源
UnsupportedOperation.DisasterRecoveryProtectGroupStateError 容灾保护组状态异常
UnsupportedOperation.DisasterRecoverySitePairBindResource 容灾站点对已绑定资源
UnsupportedOperation.DisasterRecoverySitePairStateError 站点对状态错误
UnsupportedOperation.DrillPairStateError 演练对状态异常
UnsupportedOperation.FileBackupRestoreConflict 路径冲突
UnsupportedOperation.FileBackupStateError 备份点当前状态不支持恢复操作,请等待备份完成后再试
UnsupportedOperation.FileBackupTaskDuplicate 指定路径已有创建中的备份任务,请等待完成后再试
UnsupportedOperation.HaveNoProtectionPoint 没有可用的保护点
UnsupportedOperation.InstanceSnapshotRollbacking 实例存在恢复中的整机备份任务
UnsupportedOperation.SnapshotUnavailable 备份快照不可用,无法浏览内容
UnsupportedOperation.StateError 资源状态无法进行当前操作
UnsupportedOperation.TargetResourceRollbacking 目标端资源正在回滚中