451      財經資訊

OSS錯誤響應__API 參考_對象存儲 OSS-阿裏雲

當用戶訪問OSS出現錯誤時，OSS會返回給用戶相應的錯誤碼和錯誤信息，便於用戶定位問題，並做出適當的處理。

OSS的錯誤響應格式

當用戶訪問OSS出錯時，OSS會返回給用戶一個合適的3xx，4xx或者5xx的HTTP狀態碼；以及一個application/xml格式的消息體。

錯誤響應的消息體例子：

<?xml version="1.0" ?>
<Error xmlns=”https://doc.oss-cn-hangzhou.aliyuncs.com”>
    <Code>
        AccessDenied
    </Code>
    <Message>
        Query-string authentication requires the Signature, Expires and OSSAccessKeyId parameters
    </Message>
    <RequestId>
        1D842BC5425544BB
    </RequestId>
    <HostId>
        oss-cn-hangzhou.aliyuncs.com
    </HostId>
</Error>

所有錯誤的消息體中都包括以下幾個元素：

• Code：OSS返回給用戶的錯誤碼。
• Message：OSS給出的詳細錯誤信息。
• RequestId：用於唯一標識該次請求的UUID；當你無法解決問題時，可以憑這個RequestId來請求OSS開發工程師的幫助。
• HostId：用於標識訪問的OSS集群，與用戶請求時使用的Host一致。

其他特殊的錯誤信息元素請參照每個請求的具體介紹。  

OSS的錯誤碼

OSS的錯誤碼列表如下：

OSS不支持的操作

如果試圖以OSS不支持的操作來訪問某個資源，返回405 Method Not Allowed錯誤。

錯誤請求示例：

ABC /1.txt HTTP/1.1
Host: bucketname.oss-cn-shanghai.aliyuncs.com
Date: Thu, 11 Aug 2016 03:53:40 GMT
Authorization: signatureValue

返回示例：

HTTP/1.1 405 Method Not Allowed
Server: AliyunOSS
Date: Thu, 11 Aug 2016 03:53:44 GMT
Content-Type: application/xml
Content-Length: 338
Connection: keep-alive
x-oss-request-id: 57ABF6C8BC4D25D86CBA5ADE
Allow: GET DELETE HEAD PUT POST OPTIONS
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>MethodNotAllowed</Code>
  <Message>The specified method is not allowed against this resource.</Message>
  <RequestId>57ABF6C8BC4D25D86CBA5ADE</RequestId>
  <HostId>bucketname.oss-cn-shanghai.aliyuncs.com</HostId>
  <Method>abc</Method>
  <ResourceType>Bucket</ResourceType>
</Error>

注意：如果訪問的資源是 /bucket/， ResourceType應該是bucket，如果訪問的資源是 /bucket/object，ResourceType應該是object。  

PUT /abc.zip HTTP/1.1
Host: bucketname.oss-cn-shanghai.aliyuncs.com
Accept: */*
Date: Thu, 11 Aug 2016 01:44:50 GMT
If-Modified-Since: Thu, 11 Aug 2016 01:43:51 GMT
Content-Length: 363

HTTP/1.1 400 Bad Request
Server: AliyunOSS
Date: Thu, 11 Aug 2016 01:44:54 GMT
Content-Type: application/xml
Content-Length: 322
Connection: keep-alive
x-oss-request-id: 57ABD896CCB80C366955187E
x-oss-server-time: 0
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NotImplemented</Code>
  <Message>A header you provided implies functionality that is not implemented.</Message>
  <RequestId>57ABD896CCB80C366955187E</RequestId>
  <HostId>bucketname.oss-cn-shanghai.aliyuncs.com</HostId>
  <Header>If-Modified-Since</Header>
</Error>