在调用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) 处理建议
400 MissingContentType Content-Type does not exist in http header when body is not empty. 请求Body不为空时,缺少Content-Type。 请您检查请求头,确认存在Content-Type。
400 MissingBodyRawSize x-log-bodyrawsize does not exist in header when it is necessary. 压缩场景下没有提供必须的x-log-bodyrawsize请求头。 请您检查请求头,确认存在x-log-bodyrawsize。
400 InvalidBodyRawSize x-log-bodyrawsize is invalid. x-log-bodyrawsize的值无效。 请您检查请求头,确认其取值为有效数字。
400 InvalidCompressType x-log-compresstype type is unsupported. 不支持x-log-compresstype指定的压缩方式。 请您检查请求头,确认其值为lz4或Deflate。
400 MissingHost Host does not exist in http header. 请求头缺少Host。 请您检查请求头,确认存在Host。
400 MissingDate Date does not exist in http header. 请求头缺少Date。 请您检查请求头,确认存在Date。
400 MissingAPIVersion x-log-apiversion does not exist in http header. 请求头缺少x-log-apiversion。 请您检查请求头,确认存在x-log-apiversion。
400 InvalidAPIVersion x-log-apiversion version is unsupported. HTTP请求头x-log-apiversion的值不支持。 请您检查请求头,确认支持API版本。
400 MissAccessKeyId x-log-accesskeyid does not exist in header. 没有在Authorization头部提供AccessKey ID。 请检查请求头,确认Authorization头部存在AccessKey ID。
400 MissingSignatureMethod x-log-signaturemethod does not exist in http header. 没有提供HTTP请求头x-log-signaturemethod。 请您检查请求头,确认存在x-log-signaturemethod。
400 InvalidSignatureMethod signature method method is unsupported. x-log-signaturemethod头部指定的签名方法不支持。 请您检查请求头,确认支持的签名方法。
400 RequestTimeExpired request time requestTime has been expired while server time is server time. 请求时间和服务端时间差别超过15分钟。 请您检查请求端时间,稍后重试。
400 InvalidRequestTime request time requestTime not follow RFC822 spec. 请求头中Date的值不符合RFC822标准。 请您检查请求头,确认Date取值符合RFC822标准。
400 InvalidHost Host header Host is invalid. 请求头中Host不合法。 请您检查请求头,调试请求头中Host格式。
400 ProjectAlreadyExist Project ProjectName already exist. Project名称已存在。 Project名称在阿里云地域内全局唯一。请您更换Project名称后重试。
401 SignatureNotMatch Signature signature is not matched. 请求的数字签名不匹配。 请您重试或更换AccessKey后重试。
401 Authorization Required Authorization does not exist in http header. 请求头中缺少Authorization。 请您调整请求消息头,确保已包含Authorization,其格式为Authorization: LOG yourAccessKeyId:yourSignature,然后重试。
401 Unauthorized The AccessKeyId is unauthorized. 提供的AccessKey ID值未授权。 请确认您的AccessKey ID有访问日志服务权限。
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 ID AccessKey ID不存在。 请检查您的AccessKey ID,重新获取后再发起请求。
AccessKeyId is disabled: AccessKey ID AccessKey ID是禁用状态。 请检查您的AccessKey ID,确认为已启用状态后重新发起请求。
Your SLS service has been forbidden. 日志服务已经被禁用。 请检查您的日志服务状态,例如是否已欠费。
401 InvalidAccessKeyId The access key id you provided is invalid: AccessKey ID. AccessKey ID不合法。 请检查您的AccessKey ID,确认AccessKey ID是合法有效的。
Your SLS service has not opened. 日志服务没有开通。 请登录日志服务控制台或者通过API开通日志服务后,重新发起请求。
403 WriteQuotaExceed Write quota is exceeded. 超过写入日志限额。 请您优化写入日志请求,减少写入日志数量。
403 ReadQuotaExceed Read quota is exceeded. 超过读取日志限额。 请您优化读取日志请求,减少读取日志数量。
404 ProjectNotExist The Project does not exist : name 日志项目(Project)不存在。 请您检查Project名称,确认已存在该Project。
405 InvalidMethod invalid request method : request URI 请求消息中method为不支持的接口。 请您检查method取值后重试。
411 MissingContentLength Content-Length does not exist in http header when it is necessary. 请求头中缺少Content-Length。 请您检查请求头,确认存在Content-Length。
413 PostBodyTooLarge body size bodysize must little than 10485760. 请求消息体body不能超过10M。 请您调整请求消息体的大小后重试。
415 InvalidContentType Content-Type type is unsupported. 不支持该类型的Content-Type。 请您检查Content-Type定义是否正确。
500 InternalServerError Internal server error message. 服务器内部错误。 请您稍后重试。
500 RequestTimeout The request is timeout. Please try again later. 请求处理超时。 请您稍后重试。
503 ServerBusy The server is busy, please try again later. 服务器正忙。 请您稍后重试。
说明 错误消息中斜体部分为出错相关的具体信息。例如,ProjectNotExist的错误消息中name,表示错误消息中该部分会被具体的Project名称替换。