存储桶命名规则 - Amazon Simple Storage Service
通用存储桶命名规则目录存储桶命名规则

存储桶命名规则

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

通用存储桶命名规则

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

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

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

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

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

  • 存储桶名称不得采用 IP 地址格式（例如，192.168.5.4）。

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

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

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

  • 存储桶名称不得以前缀 amzn-s3-demo- 开头。

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

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

  • 存储桶名称不得以后缀 .mrap 结尾。此后缀预留用于多区域接入点名称。有关更多信息，请参阅 命名 Amazon S3 多区域接入点的规则。

  • 存储桶名称不得以后缀 --x-s3 结尾。此后缀预留用于目录存储桶。有关更多信息，请参阅 目录存储桶命名规则。

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

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

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

重要

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

  • 存储桶名称不能被同一分区中的另一个 AWS 账户使用，直到存储桶被删除。删除存储桶后，请注意，同一分区中的另一个 AWS 账户可以使用相同的存储桶名称。

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

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

注意

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

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

通用存储桶名称示例

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

  • docexamplebucket1

  • amzn-s3-demo-bucket1

  • amzn-s3-demo-bucket

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

  • example.com

  • www.example.com

  • my.example.s3.bucket

以下示例存储桶名称无效：

  • amzn_s3_demo_bucket（包含下划线）

  • AmznS3DemoBucket（包含大写字母）

  • amzn-s3-demo-bucket-（以连字符结尾）

目录存储桶命名规则

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

  • 在选定的 AWS 区域和可用区内是唯一的。

  • 名称的长度必须介于 3（最小）到 63（最大）个字符之间，包括后缀。

  • 仅包含小写字母、数字和连字符（-）。

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

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

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

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

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

  • 存储桶名称不得以前缀 amzn-s3-demo- 开头。

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

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

  • 存储桶名称不得以后缀 .mrap 结尾。此后缀预留用于多区域接入点名称。有关更多信息，请参阅 命名 Amazon S3 多区域接入点的规则。

注意

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

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