在调用API接口过程中,若服务端返回结果中包含错误信息,则表示调用API接口失败。您可以根据本文错误码对照表查找对应的解决方法。

概述

当API请求发生错误的时候,服务端会返回错误信息,包括HTTP的Status Code和响应Body中的具体错误细节。其中响应Body中的错误细节为如下格式:

{
"errorCode" : <ErrorCode>,
"errorMessage" : <ErrorMessage>
}

您可以参考本文档指导进行处理,也可以参考API错误码中心,查看错误码详情。更多信息,请参见日志服务API错误码中心

业务错误码

业务错误码即各API接口特有的错误码。每个API所独有的错误码会在对应API文档中单独描述,请查看具体API接口文档。

通用错误码

通用错误码适用于大部分API接口,它们会出现在多个API错误响应信息中。下表描述API错误响应信息中的通用错误码。

说明 日志服务提供查询与分析日志的常见报错,便于您排查查询与分析报错。更多信息,请参见查询与分析日志的常见报错
HTTP状态码(Status Code)错误码(Error Code)错误消息(Error Message)描述(Description)处理建议
400RequestTimeExpiredRequest time requestTime has been expired while server time is server time.请求时间和服务端时间差别超过15分钟。请您检查请求端时间,稍后重试。
400InvalidRequestTimeRequest time requestTime not follow RFC822 spec.请求头中Date的值不符合RFC822标准。请您检查请求头,确认Date取值符合RFC822标准。
400InvalidHostHost header Host is invalid.请求头中Host不合法。请您检查请求头,调试请求头中Host格式。
400ProjectAlreadyExistProject ProjectName already exist.Project名称已存在。Project名称在阿里云地域内全局唯一。请您更换Project名称后重试。
400PostBodyInvalidThe request body is not valid JSON object.请求Body不是JSON格式。请重新调整请求Body之后再发起请求。
400InvalidContentTypeContent-Type type is unsupported.不支持该类型的Content-Type。请您检查Content-Type定义是否正确。
400ParameterInvalidHttp extend authorization : authorization pair is invalid.不合法的请求头authorization。请您检查请求头authorization定义是否正确。
Http extend x-log-bodyrawsize : x-log-bodyrawsize pair is invalid.不合法的请求头x-log-bodyrawsize。请您检查请求头x-log-bodyrawsize定义是否正确。
Http extend x-log-compresstype : x-log-compresstype pair is invalid.不合法的请求头x-log-compresstype。请您检查请求头x-log-compresstype定义是否正确。
x-log-signaturemethod: x-log-signaturemethod pair is invalid.x-log-signaturemethod不合法。请您检查请求头x-log-signaturemethod是否正确。
400MissingParameterMissing query key : parameter.缺少必需的请求参数。请补充缺少请求参数后重试。请求签名的构成和生成流程,请参见请求签名
Missing http extend header key : authorization.缺少请求头authorization。请补充请求头authorization参数后重试。请求签名的构成和生成流程,请参见请求签名
Missing http extend header key : x-log-bodyrawsize.缺少请求头x-log-bodyrawsize。请补充请求头x-log-bodyrawsize参数后重试。请求签名的构成和生成流程,请参见请求签名
Missing http extend header key : x-log-date.缺少请求头x-log-date。请补充请求头x-log-date参数后重试。请求签名的构成和生成流程,请参见请求签名
Missing http extend header key : x-log-signaturemethod.缺少请求头x-log-signaturemethod。请补充请求头x-log-signaturemethod参数后重试。请求签名的构成和生成流程,请参见请求签名
401SignatureNotMatchSignature signature not matched.请求的数字签名不匹配。请您重试或更换AccessKey后重试。可能存在原因包括:
  • AccessKey或STS Token已过期。请确认其是否有效。
  • 部署的日志服务SDK版本过旧。您可以登录GitHub来获取开放的源码和参考。更多信息,请参见SDK参考概述

请求签名的构成和生成流程,请参见请求签名

401UnauthorizedThe AccessKeyId is unauthorized.提供的AccessKey ID值未授权。请确认您的AccessKey ID有访问日志服务权限。为RAM用户授予日志服务操作权限,请参见创建RAM用户及授权
The security token you provided is invalid.STS Token不合法。请检查您的STS接口请求,确认STS Token是合法有效的。
The security token you provided has expired.STS Token已经过期。请重新申请STS Token后发起请求。
AccessKeyId not found: AccessKey IDAccessKey ID不存在。请检查您的AccessKey ID,重新获取后再发起请求。
AccessKeyId is disabled: AccessKey IDAccessKey ID是禁用状态。请检查您的AccessKey ID,确认为已启用状态后重新发起请求。
Your SLS service has been forbidden.日志服务已经被禁用。请检查您的日志服务状态,例如是否已欠费。
The project does not belong to you.Project不属于当前访问用户。
401InvalidAccessKeyIdThe access key id you provided is invalid: AccessKey ID.AccessKey ID不合法。请检查您的AccessKey ID,确认AccessKey ID是合法有效的。
Your SLS service has not opened. 日志服务没有开通。请登录日志服务控制台或者通过API开通日志服务后,重新发起请求。更多信息,请参见立即开通
403WriteQuotaExceedWrite quota is exceeded.超过写入日志限额。请您优化写入日志请求,减少写入日志数量。更多信息,请参见使用限制
403ReadQuotaExceedRead quota is exceeded.超过读取日志限额。请您优化读取日志请求,减少读取日志数量。更多信息,请参见使用限制
403MetaOperationQpsLimitExceededQps limit for the meta operation is exceeded.超出默认设置的QPS阈值。请您优化资源操作请求,减少资源操作次数。建议您延迟几秒后重试。
日志服务对以下管控类API进行QPS限制:
  • Project操作
  • Logstore操作
  • 索引类操作
  • 其他非数据写入、读取操作
更多信息,请参见使用限制
403ProjectForbiddenProject ProjectName has been forbidden.Project已经被禁用。请检查Project状态,您的Project当前可能已经欠费。
404ProjectNotExistThe Project does not exist : name日志项目(Project)不存在。请您检查Project名称,确认已存在该Project或者地域是否正确。
405InvalidMethodInvalid request method : request URI请求消息中method为不支持的接口。请您检查method取值后重试。
413PostBodyTooLargeBody size bodysize must little than 10485760.请求消息体body不能超过10M。请您调整请求消息体的大小后重试。
500InternalServerErrorInternal server error message.服务器内部错误。请您稍后重试。
500RequestTimeoutThe request is timeout. Please try again later.请求处理超时。请您稍后重试。
503ServerBusyThe server is busy, please try again later.服务器正忙。请您稍后重试。
说明 错误消息中斜体部分为出错相关的具体信息。例如,ProjectNotExist错误消息中name,表示错误消息中该部分会被具体的Project名称替换。