在調用API介面過程中,若服務端返回結果中包含錯誤資訊,則表示調用API介面失敗。您可以根據本文錯誤碼對照表尋找對應的解決方案。
概述
當API請求發生錯誤的時候,服務端會返回錯誤資訊,包括HTTP的Status Code和響應Body中的具體錯誤細節。其中響應Body中的錯誤細節為如下格式:
{
"errorCode" : <ErrorCode>,
"errorMessage" : <ErrorMessage>
}
您可以參考本文檔指導進行處理,也可以參考API錯誤碼中心,查看錯誤碼詳情。更多資訊,請參見Log ServiceAPI錯誤碼中心。
業務錯誤碼
業務錯誤碼即各API介面特有的錯誤碼。每個API所專屬的錯誤碼會在對應API文檔中單獨描述,請查看具體API介面文檔。
通用錯誤碼
通用錯誤碼適用於大部分API介面,它們會出現在多個API錯誤響應資訊中。下表描述API錯誤響應資訊中的通用錯誤碼。
說明 Log Service提供查詢與分析日誌的常見報錯,便於您排查查詢與分析報錯。更多資訊,請參見查詢與分析日誌的常見報錯。
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有訪問Log Service許可權。為RAM使用者授予Log Service操作許可權,請參見建立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. | Log Service已經被禁用。 | 請檢查您的Log Service狀態,例如是否已欠費。 | ||
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. | Log Service沒有開通。 | 請登入Log Service控制台或者通過API開通Log Service後,重新發起請求。更多資訊,請參見立即開通。 | ||
403 | WriteQuotaExceed | Write quota is exceeded. | 超過寫入日誌限額。 | 請您最佳化寫入日誌請求,減少寫入日誌數量。更多資訊,請參見使用限制。 |
403 | ReadQuotaExceed | Read quota is exceeded. | 超過讀取日誌限額。 | 請您最佳化讀取日誌請求,減少讀取日誌數量。更多資訊,請參見使用限制。 |
403 | MetaOperationQpsLimitExceeded | Qps limit for the meta operation is exceeded. | 超出預設設定的QPS閾值。 | 請您最佳化資源操作請求,減少資源操作次數。建議您延遲幾秒後重試。 Log Service對以下管控類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名稱替換。