View a markdown version of this page

SOAP 錯誤回應 - Amazon Simple Storage Service

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

SOAP 錯誤回應

注意

Amazon S3 的 SOAP API 不適用於新客戶，並且將於 2025 年 8 月 31 日接近生命週期結束 (EOL)。我們建議您使用 REST API 或 AWS SDKs。

在 SOAP 中，傳回給用戶端的錯誤結果是 SOAP 錯誤，其 HTTP 回應碼為 500。若未收到 SOAP 錯誤，表示要求成功。Amazon S3 的 SOAP 錯誤碼是由標準的 SOAP 1.1 錯誤碼加上Amazon S3 專用錯誤代碼 (「Server」或「Client」) 組成。例如："Server.InternalError" 或 "Client.NoSuchBucket"。SOAP 錯誤字串元素包含可供人閱讀的一般英文錯誤訊息。最後，SOAP 錯誤詳細資訊元素也包含錯誤相關的其他資訊。

例如，當您嘗試刪除不存在的物件 "Fred" 時，SOAP 回應的內文中將會出現 "NoSuchKey" SOAP 錯誤。

下列範例顯示 SOAP 錯誤回應範例。

<soapenv:Body>
  <soapenv:Fault>
    <Faultcode>soapenv:Client.NoSuchKey</Faultcode>
    <Faultstring>The specified key does not exist.</Faultstring>
    <Detail>
      <Key>Fred</Key>
    </Detail>
  </soapenv:Fault>
  </soapenv:Body>

下表說明 SOAP 錯誤回應元素

名稱 描述
Detail

錯誤中涉及之金鑰的容器

類型：容器

Ancestor：Body.Fault
Fault

錯誤資訊的容器。

類型：容器

Ancestor：內文
Faultcode

故障碼是可唯一識別錯誤條件的字串。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。如需詳細資訊，請參閱錯誤代碼清單。

類型：字串

Ancestor：Body.Fault
Faultstring

錯誤字串包含英文錯誤條件的一般描述。目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。具有更詳盡錯誤處理和適當國際化的複雜程式更有可能忽略錯誤字串。

類型：字串

Ancestor：Body.Fault
Key

識別錯誤中涉及的金鑰

類型：字串

Ancestor：Body.Fault