在调用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名称替换。