全部產品
Search
文件中心

Object Storage Service:錯誤碼概述

更新時間:Feb 28, 2024

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

相關文檔