View a markdown version of this page

SOAP 错误响应 - Amazon Simple Storage Service

SOAP 错误响应

注意

Amazon S3 的 SOAP API 不适用于新客户，并将于 2025 年 8 月 31 日接近使用寿命终止（EOL）。我们建议您使用 REST API 或 AWS 开发工具包。

在 SOAP 中，错误结果将作为 SOAP 错误 (使用 HTTP 响应代码 500) 返回到客户端。若您没有收到 SOAP 错误，则您的请求已成功。Amazon S3 SOAP 错误代码是由标准 SOAP 1.1 错误代码（“Server”或“Client”）与特定于 Amazon S3 的错误代码相连接而组成的。例如，“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

错误中涉及的键的容器

类型：容器

原级：Body.Fault
Fault

错误信息的容器。

类型：容器

原级：Body
Faultcode

故障代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。有关更多信息，请参阅错误代码列表。

类型：字符串

原级：Body.Fault
Faultstring

故障字符串包含错误条件的一般描述（英语）。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更可能忽略故障字符串。

类型：字符串

原级：Body.Fault
Key

标识错误中涉及的键

类型：字符串

原级：Body.Fault