Skip to main content

Addressing types

Last update:

A bucket can have two types of addressing:

The addressing type is selected when creating a bucket. For a bucket with Path-Style addressing, you can enable Virtual-Hosted addressing. You cannot change the addressing type from Virtual-Hosted to Path-Style.

You can view the addressing type of a created bucket in the control panel in the S3 → Buckets → bucket page → Configuration tab → Addressing type.

Virtual-Hosted addressing

Virtual-Hosted addressing allows you to use CORS. With this addressing type, the bucket name is specified at the beginning of the URL: <bucket_name>.<s3_domain>, where <s3_domain> is the S3 API domain depending on the pool.

If Virtual-Hosted addressing is enabled for a bucket, it cannot be disabled.

To enable Virtual-Hosted addressing, the bucket name must be compatible with the S3 API:

  • be unique among all user buckets that use storage via the S3 API and are hosted in the same pool;
  • comply with Amazon S3 bucket naming rules — contain only digits, Latin letters, the . and - characters; see more in the Bucket naming rules section of the Amazon documentation.

By default, a project can have no more than 100 buckets with Virtual-Hosted addressing. To increase the number of such buckets, create a ticket.

Enable Virtual-Hosted addressing

  1. In the control panel, click Products in the top menu and select S3.
  2. Go to the Buckets.
  3. Open the bucket page → Configuration.
  4. In the Addressing type block, select vHosted.
  5. Click Save.

Path-Style addressing

With this addressing type, the bucket name is specified after the URL: <s3_domain> / <bucket_name>, where <s3_domain> is the S3 API domain depending on the pool.

When using Path-Style, you cannot use CORS and there may be limitations when working with tools that use the S3 API (for example, Cyberduck).