DreamObjects Bucket Names

DreamObjects cluster migration

DreamHost is currently in the process of migrating all DreamObjects accounts to a new hardware platform.

Please review this article to identify the cluster your DreamObjects account currently resides on and the features it supports.

Overview

When choosing a name for your bucket, you’ll need to be careful to select something that’s DNS-compliant and unique. That’s because your bucket names are used as part of the hostname in the URL when accessing its contents.

Why the bucket names have to be unique

Objects stored in DreamObjects are identified by a URL that looks like this:

https://$BUCKET_NAME.objects-us-east-1.dream.io/$OBJECT_NAME

Since the bucket name is part of the hostname (in the URL), and hostnames must be unique, the bucket name also must be unique. For example, a bucket named “my-bucket” would have the URL:

https://my-bucket.objects-us-east-1.dream.io

This means that there can only be one bucket called “my-bucket” on DreamObjects. Therefore, the easiest way to create a new bucket is to assign a random name and create a domain alias for it using DreamHost Control Panel.

Rules to name a bucket

The following explains the rules to name a bucket based on which DreamObjects cluster your account currently resides on. 

Naming a bucket on DreamObjects US-East 1

The following rules apply to accounts on the US-East 1 cluster. Each bucket name:

  • Can be 3–63 characters long
  • Can only have:
    • ASCII lowercase letters
    • ASCII numbers
    • periods (.)
    • hyphens (-)
  • Cannot have a period (.) and hyphen (-) next to each other (adjacent)
  • Cannot include any Unicode characters, emoji, or non-printable ASCII
  • Must NOT be formatted as an IP address (e.g., 192.168.5.4)

Naming a bucket on DreamObjects US-East 5

The following rules apply to accounts on the US-East 5 cluster.

  • Can be 6-63 characters in length
  • Can use characters (a-z) and (-)
  • Cannot use a period (.)
  • May not start with (b2-) as this prefix is reserved
  • Cannot include any Unicode characters, emoji, or non-printable ASCII

How is DreamHost enforcing this?

Many S3-compatible clients have already enforced these stricter rules when creating new buckets. If you use a client that doesn’t enforce all of these rules, DreamObjects will return an error stating the bucket name is invalid.

If your client shows you the HTTP error response, you’ll see a 400 InvalidBucketName response code, including a link to this article.

See also

Did this article answer your questions?

Article last updated PST.

Still not finding what you're looking for?