错误码

最近更新时间: 2026-09-17 00:02:51

功能说明

如果返回结果中存在 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 表示该错误的具体信息。

错误码列表

公共错误码

错误码 说明
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 参数取值错误。
LimitExceeded 超过配额限制。
MissingParameter 缺少参数错误。
NoSuchVersion 接口版本不存在。
RequestLimitExceeded 请求的次数超过了频率限制。
ResourceInUse 资源被占用。
ResourceInsufficient 资源不足。
ResourceNotFound 资源不存在。
ResourceUnavailable 资源不可用。
UnauthorizedOperation 未授权操作。
UnknownParameter 未知参数错误。
UnsupportedOperation 操作不支持。
UnsupportedProtocol http(s)请求协议错误,只支持 GET 和 POST 请求。
UnsupportedRegion 接口不支持所传地域。

业务错误码

错误码 说明
InvalidParameter.RuleHostDuplicateErr 规则类接口,主机重复。
FailedOperation.PartSeparate 多台主机隔离,部分或全部失败。
InternalError 内部错误。
FailedOperation.APIServerFail 调用API服务失败。
ResourceUnavailable 资源不可用。
AuthFailure.UnauthorizedOperation 当前用户鉴权失败。
FailedOperation.AgentOffline 客户端已离线。
FailedOperation.TooManyStrategy 创建基线策略超过上限。
InvalidParameter.PortNoValid 端口格式不合法。
FailedOperation.NoProfessionHost 无专业版主机。
UnknownParameter 未知参数错误。
UnauthorizedOperation 未授权操作。
MissingParameter 缺少参数错误。
InvalidParameter.NameHasRepetition 名字已重复。
InvalidParameter.IpNoValid IP格式不合法。
InvalidParameter.InvalidFormat 参数格式错误。
InvalidParameter.ReverShellKeyFieldAllEmpty 进程名/目标IP/目标端口,不能同时为空。
FailedOperation.RescanVul 重新检测漏洞失败。
InvalidParameter 参数错误。
FailedOperation.LicenseExceeded 可用license数量不足,缺少1个license,请购买新license。
FailedOperation.ProtectStartFail 开启防护失败。
FailedOperation.Recover 回复木马失败。
FailedOperation.CloseProVersion 关闭专业版失败。
FailedOperation.Export 导出文件失败。
ResourceInUse 资源被占用。
InvalidParameter.MissingParameter 参数缺失。
FailedOperation.SingleSeparate 单台主机隔离失败。
UnsupportedOperation 操作不支持。
InvalidParameter.RegexRuleError 正则参数格式错误。
LimitExceeded.AreaQuota 超出批量添加数量。
InvalidParameterValue.TagNameLengthLimit 标签名称长度不能超过15个字符。
ResourceNotFound.MachineNotFound 扫描机器不存在。
InternalError.MainDBFail 操作数据失败。
InvalidParameterValue 参数取值错误。
InvalidParameter.IllegalRequest 非法请求。
FailedOperation.MachineDelete 卸载主机。
AuthFailure CAM签名/鉴权错误。
LimitExceeded 超过配额限制。
InvalidParameter.DateRange 时间区间格式错误。
FailedOperation 操作失败。
ResourceInsufficient 资源不足。
OperationDenied 操作被拒绝。
InvalidParameter.ParsingError 参数解析错误。
InvalidParameter.RuleHostipErr 规则类接口,主机IP不正确。
ResourceNotFound 资源不存在。
FailedOperation.OpenProVersion 开通专业版失败。
FailedOperation.PrePayMode 不能关闭预付费模式专业版。