錯誤碼
當(dāng)訪問OSS出現(xiàn)錯誤時，OSS會返回Code、Message、RequestId、EC等信息，方便您定位并解決問題。
錯誤響應(yīng)頭
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以下錯誤響應(yīng)頭說明如下：
響應(yīng)頭 | 說明 |
x-oss-ec | OSS的一種細(xì)粒度錯誤碼。每一個錯誤原因?qū)?yīng)一個唯一的EC（Error Code）。相比于錯誤響應(yīng)體XML中的Code，EC能更加精確地反映請求出錯的原因，同時也方便檢索對應(yīng)的解決方案。如果某個請求出現(xiàn)錯誤，EC會出現(xiàn)在該請求對應(yīng)的HTTP響應(yīng)中的響應(yīng)頭（x-oss-ec）和響應(yīng)體XML中（/Error/EC）。您可以通過EC精確查找錯誤原因和解決方法。 重要 EC僅用于問題定位，有可能發(fā)生變化，不保證前向兼容。因此，您的業(yè)務(wù)邏輯不應(yīng)該依賴于EC錯誤碼。 |
關(guān)于錯誤響應(yīng)頭中包含的Content-Length，Connection，x-oss-request-id等公共響應(yīng)頭的更多信息，請參見公共響應(yīng)頭（Common Response Headers）。
錯誤響應(yīng)體
<?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>以上錯誤響應(yīng)體包含的響應(yīng)元素說明如下：
響應(yīng)元素 | 說明 |
Code | 錯誤響應(yīng)體返回的錯誤碼。 |
Message | 錯誤響應(yīng)體返回的詳細(xì)錯誤消息。 |
RequestId | 用于唯一標(biāo)識該次請求的UUID。您可以憑借此Request ID聯(lián)系技術(shù)支持，排查并解決您遇到的問題。 |
HostId | 用于標(biāo)識訪問的OSS集群，與用戶請求時使用的Host一致。 |
EC | OSS的一種細(xì)粒度錯誤碼。每一個錯誤原因?qū)?yīng)一個唯一的EC（Error Code）。相比于錯誤響應(yīng)體XML中的Code，EC能更加精確地反映請求出錯的原因，同時也方便檢索對應(yīng)的解決方案。如果某個請求出現(xiàn)錯誤，EC會出現(xiàn)在該請求對應(yīng)的HTTP響應(yīng)中的響應(yīng)頭（x-oss-ec）和響應(yīng)體XML中（/Error/EC）。您可以通過EC精確查找錯誤原因和解決方法。 重要 EC僅用于問題定位，有可能發(fā)生變化，不保證前向兼容。因此，您的業(yè)務(wù)邏輯不應(yīng)該依賴于EC錯誤碼。 |
RecommendDoc | EC對應(yīng)的OpenAPI問題診斷鏈接。您可以單擊該鏈接，然后進(jìn)行自助排查。 |