在調用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 | 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名稱后重試。 |
400 | PostBodyInvalid | The request body is not valid JSON object. | 請求Body不是JSON格式。 | 請重新調整請求Body之后再發起請求。 |
400 | InvalidContentType | Content-Type type is unsupported. | 不支持該類型的Content-Type。 | 請您檢查Content-Type定義是否正確。 |
400 | ParameterInvalid | Http 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是否正確。 | ||
400 | MissingParameter | Missing 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參數后重試。請求簽名的構成和生成流程,請參見請求簽名。 | ||
401 | SignatureNotMatch | Signature signature not matched. | 請求的數字簽名不匹配。 | 請您重試或更換AccessKey后重試。可能存在原因包括:
請求簽名的構成和生成流程,請參見請求簽名。 |
401 | Unauthorized | The 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 ID | AccessKey ID不存在。 | 請檢查您的AccessKey ID,重新獲取后再發起請求。 | ||
AccessKeyId is disabled: AccessKey ID | AccessKey ID是禁用狀態。 | 請檢查您的AccessKey ID,確認為已啟用狀態后重新發起請求。 | ||
Your SLS service has been forbidden. | 日志服務已經被禁用。 | 請檢查您的日志服務狀態,例如是否已欠費。 | ||
The project does not belong to you. | Project不屬于當前訪問用戶。 |
| ||
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. | 超過讀取日志限額。 | 請您優化讀取日志請求,減少讀取日志數量。更多信息,請參見使用限制。 |
403 | MetaOperationQpsLimitExceeded | Qps limit for the meta operation is exceeded. | 超出默認設置的QPS閾值。 | 請您優化資源操作請求,減少資源操作次數。建議您延遲幾秒后重試。 日志服務對以下管控類API進行QPS限制:
|
403 | ProjectForbidden | Project ProjectName has been forbidden. | Project已經被禁用。 | 請檢查Project狀態,您的Project當前可能已經欠費。 |
404 | ProjectNotExist | The Project does not exist : name | 日志項目(Project)不存在。 | 請您檢查Project名稱,確認已存在該Project或者地域是否正確。 |
405 | InvalidMethod | Invalid request method : request URI | 請求消息中method為不支持的接口。 | 請您檢查method取值后重試。 |
413 | PostBodyTooLarge | Body size bodysize must little than 10485760. | 請求消息體body不能超過10M。 | 請您調整請求消息體的大小后重試。 |
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名稱替換。
文檔內容是否對您有幫助?