Amazon Simple Storage Service
开发人员指南 (API 版本 2006-03-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

(可选) 自定义错误文档支持

下表列出了发生错误时 Amazon S3 返回的 HTTP 响应代码的子集。

HTTP 错误代码 说明
301 永久移动 当用户将请求直接发送到 Amazon S3 网站终端节点 (http://s3-website-<region>.amazonaws.com.cn/) 时,Amazon S3 返回 301 Moved Permanently (301 永久移动) 响应并将这些请求重定向到 http://amazonaws.cn/s3/
302 Found (302 已找到)

当 Amazon S3 接收对不包含尾部斜杠的键 x (http://<bucket>.s3-website-<region>.amazonaws.com.cn/x) 的请求时,它首先查找键名称为 x 的对象。如果未找到对象,则 Amazon S3 确定该请求是针对子文件夹 x 发出的,并通过在末尾添加斜杠重定向请求并返回 302 Found (302 已找到)

304 Not Modified (304 未修改)

Amazon S3 用户请求标头 If-Modified-SinceIf-Unmodified-SinceIf-Match 和/或 If-None-Match 以确定所请求的对象是否与客户端保存的缓存副本相同。如果对象相同,网站终端节点将返回 304 Not Modified 响应。

400 Malformed Request

当用户尝试通过错误的区域终端节点访问存储桶时,网站终端节点的响应包含 400 Malformed Request

403 禁止访问

当用户请求转换为不可公开读取的对象时,网站终端节点的响应包含 403 Forbidden。对象所有者必须使用存储桶策略或 ACL 使该对象公开可读。

404 未找到

由于以下原因,网站终端节点的响应包含 404 Not Found

  • Amazon S3 确定网站 URL 引用了不存在的对象键。

  • Amazon 推断该请求针对不存在的索引文档。

  • 在 URL 中指定的存储桶不存在。

  • URL 中指定的存储桶存在,但未配置为网站。

您可以创建为 404 Not Found 返回的自定义文档。确保该文档已上传到配置为网站的存储桶,且网站托管配置已设置为使用该文档。

有关 Amazon S3 如何将 URL 解释为对对象或索引文档的请求的信息,请参阅配置索引文档支持

500 Service Error

当出现内部服务器错误时,网站终端节点的响应包含 500 Service Error

503 服务不可用

当 Amazon S3 确定您需要降低请求率时,网站终端节点的响应包含 503 Service Unavailable (503 服务不可用)

对于其中每个错误,Amazon S3 都返回一条预定义的 HTML 消息。以下是对 403 Forbidden 响应返回的 HTML 消息示例。

 “403 禁止访问”错误消息示例

自定义错误文档

(可选) 您可以提供包含用户友好错误消息和其他帮助的自定义错误文档。您将提供此自定义错误文档作为将网站配置添加到您的存储桶的一部分。Amazon S3 将仅为 HTTP 4XX 类的错误代码返回您的自定义错误文档。

错误文档和浏览器行为

出现错误时,Amazon S3 返回 HTML 错误文档。如果您为网站配置了自定义错误文档,则 Amazon S3 将返回该错误文档。但是,当出现错误时,某些浏览器将显示自己的错误消息,而忽略 Amazon S3 返回的错误文档。例如,当出现“HTTP 404 未找到”错误时,Google Chrome 可能忽略 Amazon S3 返回的错误文档并显示自己的错误。