當訪問OSS出現錯誤時,OSS會返回Code、Message、RequestId、EC等資訊,方便您定位並解決問題。
錯誤回應標頭
HTTP/1.1 403 Forbidden
Server: AliyunOSS
Date: Wed, 09 Nov 2022 08:45:46 GMT
Content-Type: application/xml
Content-Length: 471
Connection: keep-alive
x-oss-request-id: 636B68BA80DA8539399F****
x-oss-server-time: 0
x-oss-ec: 0003-00000001
以下錯誤回應標頭說明如下:
回應標頭 | 說明 |
x-oss-ec | OSS的一種細粒度錯誤碼。每一個錯誤原因對應一個唯一的EC(Error Code)。相比於錯誤響應體XML中的Code,EC能更加精確地反映請求出錯的原因,同時也方便檢索對應的解決方案。如果某個請求出現錯誤,EC會出現在該請求對應的HTTP響應中的回應標頭(x-oss-ec)和響應體XML中(/Error/EC)。您可以通過EC精確尋找錯誤原因和解決方案。 重要 EC僅用於問題定位,有可能發生變化,不保證前向相容。因此,您的商務邏輯不應該依賴於EC錯誤碼。 |
關於錯誤回應標頭中包含的Content-Length,Connection,x-oss-request-id等公用回應標頭的更多資訊,請參見公用回應標頭(Common Response Headers)。
錯誤響應體
<?xml version="1.0" ?>
<Error xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<Code>MalformedXML</Code>
<Message>The XML you provided was not well-formed or did not validate against our published schema.</Message>
<RequestId>57ABD896CCB80C366955****</RequestId>
<HostId>oss-cn-hangzhou.aliyuncs.com</HostId>
<EC>0031-00000001</EC>
<RecommendDoc>https://api.aliyun.com/troubleshoot?q=0031-00000001</RecommendDoc>
</Error>
以上錯誤響應體包含的響應元素說明如下:
響應元素 | 說明 |
Code | 錯誤響應體返回的錯誤碼。 |
Message | 錯誤響應體返回的詳細錯誤訊息。 |
RequestId | 用於唯一標識該次請求的UUID。您可以憑藉此Request ID聯絡支援人員,排查並解決您遇到的問題。 |
HostId | 用於標識訪問的OSS叢集,與使用者請求時使用的Host一致。 |
EC | OSS的一種細粒度錯誤碼。每一個錯誤原因對應一個唯一的EC(Error Code)。相比於錯誤響應體XML中的Code,EC能更加精確地反映請求出錯的原因,同時也方便檢索對應的解決方案。如果某個請求出現錯誤,EC會出現在該請求對應的HTTP響應中的回應標頭(x-oss-ec)和響應體XML中(/Error/EC)。您可以通過EC精確尋找錯誤原因和解決方案。 重要 EC僅用於問題定位,有可能發生變化,不保證前向相容。因此,您的商務邏輯不應該依賴於EC錯誤碼。 |
RecommendDoc | EC對應的OpenAPI問題診斷連結。您可以單擊該連結,然後進行自助排查。 |