Amazon Simple Storage Service
开发人员指南 (API Version 2006-03-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

配置索引文档支持

索引文档 是在对网站的根或任何子文件夹发出请求时 Amazon S3 返回的网页。例如,如果用户在浏览器中输入 http://www.example.com,则该用户没有请求任何特定页面。在这种情况下,Amazon S3 将提供索引文档,该文档有时也称为默认页面。

当您将您的存储桶配置为网站时,应该提供索引文档的名称。然后必须上传具有此名称的对象并将其配置为公开可读。

根级 URL 的尾部斜杠是可选的。例如,如果您将具有 index.html 的网站配置为索引文档,以下任意一个 URL 将返回 index.html

http://example-bucket.s3-website-region.amazonaws.com/ http://example-bucket.s3-website-region.amazonaws.com

有关 Amazon S3 网站终端节点的更多信息,请参阅网站终端节点

索引文档和文件夹

在 Amazon S3 中,存储桶是对象的平面容器;它不会像计算机上的文件系统那样提供任何分层组织。您可以通过使用表示文件夹结构的对象键名称创建逻辑层级结构。例如,考虑具有三个对象的存储桶和以下键名称。

  • sample1.jpg

  • photos/2006/Jan/sample2.jpg

  • photos/2006/Feb/sample3.jpg

虽然它们没有按任何物理分层组织进行存储,但您可以从键名称推断以下逻辑文件夹结构。

  • sample1.jpg 对象位于存储桶的根级.

  • sample2.jpg 对象位于 photos/2006/Jan 子文件夹中。

  • sample3.jpg 对象位于 photos/2006/Feb 子文件夹中。

Amazon S3 控制台支持的文件夹概念基于对象键名称。要继续以前的示例,控制台需显示包含 photos 文件夹的 examplebucket

您可以将对象上传到存储桶或该存储桶中的 photos 文件夹。如果您将对象 sample.jpg 添加到存储桶,则键名称为 sample.jpg。如果您将对象上传到 photos 文件夹,则对象键名称为 photos/sample.jpg

如果您在存储桶中创建了此类文件夹结构,则您必须在每个级别上都具有索引文档。当用户指定类似于文件夹查找的 URL 时,是否存在尾部斜杠将决定网站的行为。例如,以下具有尾部反斜杠的 URL 将返回 photos/index.html 索引文档。

http://example-bucket.s3-website-region.amazonaws.com/photos/

但是,如果您从之前的 URL 排除尾部斜杠,则 Amazon S3 将首先在存储桶中查找对象 photos。如果未找到 photos 对象,则将搜索索引文档 photos/index.html。如果找到该文档,则 Amazon S3 返回 302 Found 消息并指向 photos/ 键。对于对 photos/ 的后续请求,Amazon S3 返回 photos/index.html。如果未找到索引文档,Amazon S3 将返回错误。

本页内容: