REST 錯誤回應- Amazon Simple Storage Service

當Amazon S3 請求發生錯誤時，用戶端會收到錯誤回應。

錯誤回應的確切格式 ... 許多錯誤回應包含額外的結構化資料，負責診斷程式設計錯誤的開發人員應詳加閱讀及了解。

REST錯誤回應-AmazonSimpleStorageServiceAWS文件AmazonSimpleStorageService(S3)使用者指南回應標頭錯誤回應REST錯誤回應當REST要求造成錯誤時，HTTP回覆會包含： XML錯誤文件作為回應內文 Content-Type:application/xml 適當的3xx、4xx或5xxHTTP狀態碼 以下是REST錯誤回應範例。

NoSuchKey Theresourceyourequesteddoesnotexist /mybucket/myfoto.jpg 4442587FB7D0A2F9 如需AmazonS3錯誤的詳細資訊，請前往ErrorCodeList。

回應標頭 以下是所有操作傳回的回應標頭： x-amz-request-id:指派給每個要求的專用ID。

當AmazonS3發生問題時，Amazon可能會使用此ID協助疑難排解問題，但這個可能性極低。

x-amz-id-2:協助我們疑難排解問題的特殊字符。

錯誤回應 當AmazonS3請求發生錯誤時，用戶端會收到錯誤回應。

錯誤回應的確切格式隨API而異。

例如，REST錯誤回應與SOAP錯誤回應就不相同。

但所有錯誤回應都有共同的元素。

注意HTTP上的SOAP支援已淘汰，但仍可透過HTTPS取得。

SOAP不支援新的AmazonS3功能。

建議您使用RESTAPI或AWS開發套件。

錯誤代碼 錯誤代碼是一個字串，專門用於識別錯誤狀況。

偵測及依類型處理錯誤的程式必須讀取及了解此代碼。

SOAP與RESTAPI有許多共通的錯誤代碼，但有些會隨API而異。

例如，NoSuchKey兩者都有，但UnexpectedContent只會出現在無效REST要求的回應中。

在所有案例中，SOAP錯誤碼都包含錯誤代碼表中指出的字首，因此，SOAP中傳回的NoSuchKey錯誤，實際會顯示為Client.NoSuchKey。

注意HTTP上的SOAP支援已淘汰，但仍可透過HTTPS取得。

SOAP不支援新的AmazonS3功能。

建議您使用RESTAPI或AWS開發套件。

錯誤訊息 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。

一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。

複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

更多詳細資訊 許多錯誤回應包含額外的結構化資料，負責診斷程式設計錯誤的開發人員應詳加閱讀及了解。

例如，若您傳送之RESTPUT要求中所包含的Content-MD5標頭，不符合伺服器計算所得的摘要，您就會收到BadDigest錯誤。

錯誤回應也會包含在詳細資訊元素中計算所得的摘要，以及您告訴我們應有的摘要。

您可以在開發時使用此資訊診斷錯誤。

在生產環境中，一支運作良好的程式可能將此資訊包含在其錯誤日誌中。

文件慣用形式錯誤處理SOAP錯誤回應此頁面是否有幫助？-是感謝您，讓我們知道我們做得很好！若您有空，歡迎您告知我們值得讚許的地方，這樣才能保持良好服務。

此頁面是否有幫助？-否感謝讓我們知道此頁面仍須改善。

很抱歉，讓您失望。

若您有空，歡迎您提供改善文件的方式。