存储桶命名规则 - Amazon Simple Storage Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

存储桶命名规则

以下规则适用于在 Amazon S3 中命名通用存储桶和目录存储桶:

通用存储桶命名规则

以下命名规则适用于通用存储桶。

  • 存储桶名称必须介于 3(最少)到 63(最多)个字符之间。

  • 存储桶名称只能由小写字母、数字、句点(.)和连字符(-)组成。

  • 存储桶名称必须以字母或数字开头和结尾。

  • 存储桶名称不得包含两个相邻的句点。

  • 存储桶名称不得采用 IP 地址格式(例如,192.168.5.4)。

  • 存储桶名称不得以前缀 xn-- 开头。

  • 存储桶名称不得以前缀 sthree- 和前缀 sthree-configurator 开头。

  • 存储桶名称不得以后缀 -s3alias 结尾。此后缀是为接入点别名预留的。有关更多信息,请参阅为您的 S3 存储桶接入点使用存储桶式别名

  • 存储桶名称不得以后缀 --ol-s3 结尾。此后缀是为对象 Lambda 接入点别名预留的。有关更多信息,请参阅如何为您的 S3 存储桶对象 Lambda 接入点使用存储桶式别名

  • 存储桶名称在分区内所有 Amazon Web Services 区域中的所有 Amazon Web Services 账户间必须是唯一的。分区是一组区域。Amazon 目前有三个分区:aws(标准区域)、aws-cn(中国区域)和 aws-us-gov(Amazon GovCloud (US))。

  • 存储桶名称不能被同一分区中的另一个 Amazon Web Services 账户使用,直到存储桶被删除。

  • 与 Amazon S3 Transfer Acceleration 一起使用的存储桶名称中不能有句点(.)。有关 Transfer Acceleration 的更多信息,请参阅使用 Amazon S3 Transfer Acceleration 配置快速、安全的文件传输

为了获得最佳兼容性,我们建议您避免在存储桶名称中使用句点(.),但仅用于静态网站托管的存储桶除外。如果您在存储桶名称中包含句点,则无法通过 HTTPS 使用虚拟主机式寻址,除非您执行自己的证书验证。这是因为用于存储桶虚拟托管的安全证书不适用于名称中带有句点的存储桶。

此限制不会影响用于静态网站托管的存储桶,因为静态网站托管只能通过 HTTP 提供。有关虚拟主机式寻址的更多信息,请参阅存储桶的虚拟托管。有关静态网站托管的更多信息,请参阅使用 Amazon S3 托管静态网站

注意

2018 年 3 月 1 日之前,在美国东部(弗吉尼亚北部)区域中创建的存储桶的名称最多可包含 255 个字符,并且包括大写字母和下划线。自 2018 年 3 月 1 日起,美国东部(弗吉尼亚北部)中的新存储桶必须符合在所有其他区域中应用的相同规则。

有关对象键名称的信息,请参阅创建对象键名称

通用存储桶名称示例

以下示例存储桶名称是有效的,并遵循建议的通用存储桶命名准则:

  • docexamplebucket1

  • log-delivery-march-2020

  • my-hosted-content

以下示例存储桶名称是有效的,但不推荐用于静态网站托管以外的其他用途:

  • docexamplewebsite.com

  • www.docexamplewebsite.com

  • my.example.s3.bucket

以下示例存储桶名称无效

  • doc_example_bucket(包含下划线)

  • DocExampleBucket(包含大写字母)

  • doc-example-bucket-(以连字符结尾)

目录存储桶命名规则

目录存储桶名称必须:

  • 在选定的 Amazon Web Services 区域和可用区内是唯一的。

  • 长度介于 3–63 个字符之间,包括后缀。

  • 仅包含小写字母、数字和连字符(-)。

  • 以字母或数字开头和结尾。

  • 必须包含以下后缀:--azid--x-s3

注意

当您使用控制台创建目录存储桶时,会自动将后缀添加到您提供的基本名称中。此后缀包括您选择的可用区的可用区 ID。

当您使用 API 创建目录存储桶时,必须在请求中提供包括可用区 ID 在内的完整后缀。有关可用区 ID 的列表,请参阅 S3 Express One Zone 可用区和区域