Bucket naming rules
The following rules apply for naming general purpose buckets and directory buckets in Amazon S3:
General purpose buckets naming rules
The following naming rules apply for general purpose buckets.
-
Bucket names must be between 3 (min) and 63 (max) characters long.
-
Bucket names can consist only of lowercase letters, numbers, dots (.), and hyphens (-).
-
Bucket names must begin and end with a letter or number.
-
Bucket names must not contain two adjacent periods.
-
Bucket names must not be formatted as an IP address (for example, 192.168.5.4).
-
Bucket names must not start with the prefix
xn--
. -
Bucket names must not start with the prefix
sthree-
. -
Bucket names must not start with the prefix
sthree-configurator
. -
Bucket names must not start with the prefix
amzn-s3-demo-
. -
Bucket names must not end with the suffix
-s3alias
. This suffix is reserved for access point alias names. For more information, see Using a bucket-style alias for your S3 bucket access point. -
Bucket names must not end with the suffix
--ol-s3
. This suffix is reserved for Object Lambda Access Point alias names. For more information, see How to use a bucket-style alias for your S3 bucket Object Lambda Access Point. -
Bucket names must not end with the suffix
.mrap
. This suffix is reserved for Multi-Region Access Point names. For more information, see Rules for naming Amazon S3 Multi-Region Access Points. -
Bucket names must not end with the suffix
--x-s3
. This suffix is reserved for directory buckets. For more information, see Directory bucket naming rules. -
Bucket names must be unique across all AWS accounts in all the AWS Regions within a partition. A partition is a grouping of Regions. AWS currently has three partitions:
aws
(Standard Regions),aws-cn
(China Regions), andaws-us-gov
(AWS GovCloud (US)). -
A bucket name cannot be used by another AWS account in the same partition until the bucket is deleted.
-
Buckets used with Amazon S3 Transfer Acceleration can't have dots (.) in their names. For more information about Transfer Acceleration, see Configuring fast, secure file transfers using Amazon S3 Transfer Acceleration.
Important
-
Bucket names must be unique across all AWS accounts in all the AWS Regions within a partition. A partition is a grouping of Regions. AWS currently has three partitions:
aws
(Standard Regions),aws-cn
(China Regions), andaws-us-gov
(AWS GovCloud (US)). -
A bucket name cannot be used by another AWS account in the same partition until the bucket is deleted. After you delete a bucket, be aware that another AWS account in the same partition can use the same bucket name.
For best compatibility, we recommend that you avoid using dots (.) in bucket names, except for buckets that are used only for static website hosting. If you include dots in a bucket's name, you can't use virtual-host-style addressing over HTTPS, unless you perform your own certificate validation. This is because the security certificates used for virtual hosting of buckets don't work for buckets with dots in their names.
This limitation doesn't affect buckets used for static website hosting, because static website hosting is only available over HTTP. For more information about virtual-host-style addressing, see Virtual hosting of buckets. For more information about static website hosting, see Hosting a static website using Amazon S3.
Note
Before March 1, 2018, buckets created in the US East (N. Virginia) Region could have names that were up to 255 characters long and included uppercase letters and underscores. Beginning March 1, 2018, new buckets in US East (N. Virginia) must conform to the same rules applied in all other Regions.
For information on object key names, see Creating object key names.
Example general purpose bucket names
The following example bucket names are valid and follow the recommended naming guidelines for general purpose buckets:
-
docexamplebucket1
-
amzn-s3-demo-bucket1
-
amzn-s3-demo-bucket
The following example bucket names are valid but not recommended for uses other than static website hosting:
-
example.com
-
www.example.com
-
my.example.s3.bucket
The following example bucket names are not valid:
-
amzn_s3_demo_bucket
(contains underscores) -
AmznS3DemoBucket
(contains uppercase letters) -
amzn-s3-demo-bucket-
(ends with a hyphen)
Directory bucket naming rules
The following naming rules apply for directory buckets.
-
Be unique within the chosen AWS Region and Availability Zone.
-
Name must be between 3 (min) and 63 (max) characters long, including the suffix.
-
Consists only of lowercase letters, numbers and hyphens (-).
-
Begin and end with a letter or number.
-
Must include the following suffix:
--
.azid
--x-s3 -
Bucket names must not start with the prefix
xn--
. -
Bucket names must not start with the prefix
sthree-
. -
Bucket names must not start with the prefix
sthree-configurator
. -
Bucket names must not start with the prefix
amzn-s3-demo-
. -
Bucket names must not end with the suffix
-s3alias
. This suffix is reserved for access point alias names. For more information, see Using a bucket-style alias for your S3 bucket access point. -
Bucket names must not end with the suffix
--ol-s3
. This suffix is reserved for Object Lambda Access Point alias names. For more information, see How to use a bucket-style alias for your S3 bucket Object Lambda Access Point. -
Bucket names must not end with the suffix
.mrap
. This suffix is reserved for Multi-Region Access Point names. For more information, see Rules for naming Amazon S3 Multi-Region Access Points.
Note
When you create a directory bucket by using the console a suffix is automatically added to the base name that you provide. This suffix includes the Availability Zone ID of the Availability Zone that you chose.
When you create a directory bucket by using an API you must provide the full suffix, including the Availability Zone ID, in your request. For a list of Availability Zone IDs, see S3 Express One Zone Availability Zones and Regions.