Bucket Naming Rules | Tigris Object Storage Documentation

On this page

In Tigris, buckets are global, each requiring a unique name. In addition, there are specific rules that must be followed when creating a bucket. Let's review these rules below.

Rules

The following naming rules apply for buckets.

• Bucket name must be between [3, 63] characters
• Bucket name can only contain lowercase characters, numbers, dots, and hyphens.

Using a dot (.) will disable virtual-hosted style access on public content domains (e.g., https://foo.bucket.t3.tigrisbucket.io) for a bucket. However, you can still access it through a correctly configured custom domain.

• Bucket names must not contain two adjacent periods
• Name must start with a number or a lowercase character
• Name must end with a number or a lowercase character
• Prefix xn-- is reserved and not allowed in the bucket prefix
• Suffix -s3alias is reserved and not allowed in the bucket suffix
• Bucket name cannot be IP addresses

Example bucket names

The following bucket names show examples of which characters are allowed in bucket names: a-z, 0-9, dots (.), and hyphens (-).

tigris-demo-bucket1-a1b2c3d4-5678-90ab-cdef-example11111
tigris-demo-bucket
example.com
www.example.com
my.example.tigris.bucket

The following example bucket names are not valid:

tigris_demo_bucket (contains underscores)
TigrisDemoBucket (contains uppercase letters)
tigris-demo-bucket- (ends with a hyphen)
example..com (contains two adjacent periods)
192.168.5.4 (matches format of an IP address)
xn--examplebucket (starts with reserved prefix)
examplebucket-s3alias (ends with reserved suffix)