Directory bucket naming rules - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Directory bucket naming rules

When you create a directory bucket in Amazon S3, the following bucket naming rules apply. For general purpose bucket naming rules, see Bucket naming rules.

A directory bucket name consists of a base name that you provide, and a suffix that contains the ID of the Amazon Availability Zone that your bucket is located in and --x-s3.


For example, the following directory bucket name contains the Availability Zone ID usw2-az1:


When you create a directory bucket 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 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.

Directory bucket names must:

  • Be unique within the chosen Amazon Web Services 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.