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

使用 Amazon S3 存储桶

要向 Amazon S3 上传数据(照片、视频、文档等),您必须首先在其中一个 AWS 区域中创建 S3 存储桶。然后,您可以将任何数量的对象上传到该存储桶。

对于实施,存储桶和对象是资源,而 Amazon S3提供 API 供您管理资源。例如,您可以使用 Amazon S3 API 创建存储桶并上传对象。您还可以使用 Amazon S3 控制台执行这些操作。该控制台使用 Amazon S3 API 向 Amazon S3 发送请求。

本节介绍如何使用存储桶。有关使用对象的信息,请参阅使用 Amazon S3 对象

Amazon S3 存储桶名称是全局唯一的,并且命名空间由所有 AWS 账户共享。这意味着,在创建存储桶之后,任何 AWS 区域中的其他 AWS 账户均不能使用该存储桶的名称,直至删除该存储桶。不应依赖特定的存储桶命名约定来实现可用性或安全验证。有关存储桶命名准则,请参阅存储桶限制

Amazon S3 可在指定的区域中创建存储桶。为优化延迟、最大限度地降低成本或满足法规要求,请选择地理上靠近您的任何 AWS 区域。例如,如果您位于欧洲,您可能会发现在欧洲(爱尔兰)或欧洲(法兰克福)区域创建存储桶十分有利。有关 Amazon S3 区域的列表,请参阅 AWS 一般参考 中的区域和终端节点

注意

属于您在特定 AWS 区域中创建的存储桶的对象永远不会离开该区域,除非您明确将其传输到另一个区域。例如,欧洲(爱尔兰) 区域中存储的对象永远不会离开该区域。

创建存储桶

Amazon S3 提供 API 以创建和管理存储桶。默认情况下,您可以在每个 AWS 账户中创建多达 100 个存储桶。如果您需要更多存储桶,则可以通过提交服务限制提高请求将账户的存储桶限制提高至最多 1,000 个存储桶。要了解如何提交存储桶限额提升,请参阅 AWS 一般参考 中的 AWS 服务限制

创建存储桶时,您需提供名称以及要在其中创建存储桶的 AWS 区域。有关如何命名存储桶的信息,请参阅存储桶命名规则

一个存储桶中可以存储任意数量的对象。

可以使用以下任何方法创建存储桶:

  • 使用控制台

  • 以编程方式使用 AWS 开发工具包

    注意

    如果需要,也可以直接从代码中调用 Amazon S3 REST API。但是,这可能会比较繁琐,因为需要您编写代码对请求进行身份验证。有关更多信息,请参阅 Amazon Simple Storage Service API Reference 中的 PUT Bucket

    使用 AWS 开发工具包时,您应先创建一个客户端,然后使用该客户端发送创建存储桶的请求。 您可以在创建客户端时指定 AWS 区域。美国东部(弗吉尼亚北部)是默认区域。请注意以下几点:

    • 如果通过指定美国东部(弗吉尼亚北部)区域创建客户端,则客户端将使用以下终端节点与 Amazon S3 通信:

      s3.amazonaws.com

      注意

      • 您可以使用此客户端在 2019 年 3 月 20 日之前发布的任何 AWS 区域中创建存储桶。要在 2019 年 3 月 20 日之后发布的区域中创建存储桶,您必须创建一个特定于您要在其中创建存储桶的区域的客户端。有关启用或禁用 AWS 区域的更多信息,请参阅 AWS General Reference 中的 AWS 区域和终端节点

      • 在 2020 年 9 月 30 日之后创建的存储桶将仅支持虚拟托管式请求。在此日期或之前创建的存储桶将继续支持路径式请求。有关更多信息,请参阅 Amazon S3 路径弃用计划 - 案例的其余部分

      在创建存储桶请求中:

      • 如果您未指定区域,则 Amazon S3 将在美国东部(弗吉尼亚北部)区域中创建存储桶。

      • 如果指定 AWS 区域,则 Amazon S3 将在指定区域中创建存储桶。

    • 如果通过指定其他 AWS 区域来创建客户端,则其中每个区域都映射到特定于区域的终端节点:

      s3.<region>.amazonaws.com.cn

      例如,如果您通过指定 eu-west-1 区域创建客户端,则它将映射到以下特定于区域的终端节点:

      s3.eu-west-1.amazonaws.com.cn

      在这种情况下,只能使用客户端在 eu-west-1 区域中创建存储桶。如果在创建存储桶请求中指定其他任何区域,Amazon S3 都将返回错误。

    • 如果您创建客户端来访问双堆栈终端节点,则必须指定 AWS 区域。有关更多信息,请参阅 双堆栈终端节点

    有关可用 AWS 区域的列表,请参阅 AWS General Reference 中的区域和终端节点

有关示例,请参阅 创建存储桶的示例

关于权限

您可以使用 AWS 账户根凭证创建存储桶并执行其他 Amazon S3 操作。但是,AWS 建议不要使用 AWS 账户的根凭证发出请求 (如创建存储桶)。而是创建一个 IAM 用户,并向该用户授予完全访问权限 (用户在默认情况下没有任何权限)。我们将这些用户称为管理员用户。您可以使用管理员用户凭证而不是您账户的根凭证来与 AWS 交互和执行任务,例如创建存储桶,创建用户和授予他们权限。

有关更多信息,请参阅根账户凭证与IAM 用户凭证(在 AWS 一般参考 中)和 IAM 最佳实践(在 IAM 用户指南 中)。

创建资源的 AWS 账户拥有该资源。例如,如果您在您的 AWS 账户中创建一个 IAM 用户并向该用户授予创建存储桶的权限,则该用户可以创建存储桶。但是用户不拥有存储桶;用户所属的 AWS 账户拥有存储桶。用户需要资源拥有者提供其他权限来执行任何其他存储桶操作。有关为您的 Amazon S3 资源管理权限的更多信息,请参阅Amazon S3 中的 Identity and Access Management

管理对存储桶的公有访问

通过访问控制列表 (ACL) 和/或存储桶策略向存储桶和对象授予公有访问权限。为了帮助您管理对 Amazon S3 资源的公有访问,Amazon S3 提供阻止公有访问设置。Amazon S3 阻止公有访问设置可以覆盖 ACL 和存储桶策略,以便您可以对这些资源的公有访问实施统一限制。您可以将阻止公有访问设置应用于您的账户中的单个存储桶或所有存储桶。

为了帮助确保您的所有 Amazon S3 存储桶和对象阻止了公有访问,我们建议为您的账户启用阻止公有访问的所有四个设置。这些设置阻止所有当前和将来的存储桶的公有访问。

在应用这些设置之前,请确认您的应用程序在没有公有访问的情况下能够正常工作。如果您需要对存储桶或对象进行某种级别的公有访问,例如,按照在 Amazon S3 上托管静态网站中所述托管静态网站,则可以自定义各个设置以符合您的存储使用案例要求。有关更多信息,请参阅使用 Amazon S3 阻止公有访问

访问存储桶

可以使用 Amazon S3 控制台访问存储桶。可以使用控制台 UI 执行几乎所有存储桶操作,而不必编写任何代码。

如果您以编程方式访问存储桶,请注意 Amazon S3 支持 RESTful 架构,在该架构中,存储桶和对象是资源,各自具有唯一标识资源的资源 URI。

Amazon S3 支持虚拟托管类型和路径类型 URL 访问存储桶。

  • 在虚拟托管类型 URL 中,存储桶名称是 URL 中域名的一部分。例如:  

    • http://bucket.s3-aws-region.amazonaws.com.cn

    • http://bucket.s3.amazonaws.com

      注意

      在 2019 年 3 月 20 日之后发布的区域中创建的存储桶将无法通过 https://bucket.s3.amazonaws.com 命名方案进行访问。

    在虚拟托管类型 URL 中,您可以使用其中任一终端节点。如果向 http://bucket.s3.amazonaws.com 终端节点发出请求,则 DNS 具有足够信息将请求直接路由到存储桶所位于的区域。

    有关更多信息,请参阅 存储桶的虚拟托管

     

  • 在路径类型 URL 中,存储桶名称不是域名的一部分。例如:

    • 特定于区域的终端节点 http://s3-aws-region.amazonaws.com/bucket

    • 美国东部(弗吉尼亚北部)区域终端节点,http://s3.amazonaws.com/bucket

    在路径类型 URL 中,使用的终端节点必须与存储桶所在的区域匹配。例如,如果存储桶位于南美洲(圣保罗)区域中,则必须使用 http://s3.sa-east-1.amazonaws.com/bucket 终端节点。如果存储桶位于美国东部 (弗吉尼亚北部) 区域,则必须使用 http://s3.amazonaws.com/bucket 终端节点。

重要

由于可以使用路径样式和虚拟托管样式的 URL 访问存储桶,因此,建议您使用符合 DNS 标准的存储桶名称创建存储桶。有关更多信息,请参阅 存储桶限制

通过 IPv6 访问 S3 存储桶

Amazon S3 有一组双堆栈终端节点,它们支持通过 Internet 协议版本 6 (IPv6) 和 IPv4 向 S3 存储桶发出请求。有关更多信息,请参阅 通过 IPv6 发出请求

存储桶配置选项

Amazon S3 支持各种供您用于配置存储桶的选项。例如,您可以配置存储桶用于网站托管、添加配置以管理存储桶中对象的生命周期以及配置存储桶以记录对存储桶的所有访问。Amazon S3 支持供您存储和管理存储桶配置信息的子资源。即,使用 Amazon S3 API 可以创建和管理这些子资源。还可以使用控制台或 AWS 开发工具包。

注意

还有对象级配置。例如,可以通过特定于该对象的配置访问控制列表 (ACL) 来配置对象级权限。

这些称为子资源,因为它们存在于特定存储桶或对象的上下文中。下表列出使您可以管理特定于存储桶的配置的子资源。

子资源 描述

cors(跨源资源共享)

您可以配置存储桶以便允许跨源请求。

有关更多信息,请参阅启用跨源资源共享

事件通知

您可以使存储桶向您发送特定存储桶事件的通知。

有关更多信息,请参阅 配置 Amazon S3 事件通知

生命周期

您可以为存储桶中明确定义了生命周期的对象定义生命周期规则。例如,您可以定义一个规则以在创建一年之后存档对象,或在创建 10 年之后删除对象。

有关更多信息,请参阅对象生命周期管理

位置

创建存储桶时,请指定需要 Amazon S3 在其中创建存储桶的 AWS 区域。Amazon S3 将此信息存储在位置子资源中并提供 API 用于检索此信息。

日志记录

日志记录使您可以跟踪针对存储桶的访问请求。每个访问日志记录都提供有关单个访问请求的详细信息,如请求者、存储桶名称、请求时间、请求操作、响应状态和错误代码 (如果有)。访问日志信息可能在安全和访问审核方面十分有用。它还可以帮助您了解您的客户群并了解您的 Amazon S3 账单。 

有关更多信息,请参阅 Amazon S3 服务器访问日志记录

对象锁定

要使用 Amazon S3 对象锁定,您必须为存储桶启用它。您还可以选择配置将应用于存储桶中放置的新对象的默认保留模式和保留周期。

有关更多信息,请参阅 存储桶配置

策略ACL(访问控制列表)

所有资源(如存储桶和对象)在默认情况下均为私有。Amazon S3 支持存储桶策略和访问控制列表 (ACL) 选项,供您用于授予和管理存储桶级权限。Amazon S3 将权限信息存储在策略acl 子资源中。

有关更多信息,请参阅 Amazon S3 中的 Identity and Access Management

复制

复制是在相同或跨不同 AWS 区域中的存储桶自动、异步地复制对象。有关更多信息,请参阅复制

requestPayment

默认情况下,创建存储桶的 AWS 账户 (存储桶拥有者) 支付从存储桶进行的下载。存储桶拥有者可以使用此子资源指定对请求下载的人员收取下载费用。Amazon S3 提供了一个 API,用于管理此子资源。

有关更多信息,请参阅 申请方付款存储桶

标记

您可以向存储桶添加成本分配标签以便对 AWS 成本进行分类和跟踪。Amazon S3 提供标记 子资源以对存储桶上的标签进行存储和管理。通过使用应用于您存储桶的标签,AWS 可生成成本分配报告,其中按标签汇总了使用和成本。

有关更多信息,请参阅 S3 存储桶的账单和使用率报告

传输加速

Transfer Acceleration 可在客户端与 S3 存储桶之间实现快速、轻松、安全的远距离文件传输。Transfer Acceleration 利用 Amazon CloudFront 的全球分布式边缘站点。

有关更多信息,请参阅 Amazon S3 Transfer Acceleration

版本控制

版本控制可帮助恢复意外覆盖和删除。

我们建议将版本控制作为从错误删除或覆盖恢复对象的最佳实践。

有关更多信息,请参阅 使用版本控制

网站

您可以配置存储桶以便用于静态网站托管。Amazon S3 通过创建网站 子资源来存储此配置。

有关更多信息,请参阅在 Amazon S3 上托管静态网站