當訪問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問題診斷鏈接。您可以單擊該鏈接,然后進行自助排查。 |