Skip to main content

Addressing types

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 addressing from Virtual-Hosted to Path-Style.

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

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 the buckets of all users who use the storage via the S3 API and are located in the same pool;
  • follow the Amazon S3 bucket naming rules: contain only numbers, Latin letters, the . and - characters; for more information, see the Bucket naming rules guide in 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, submit a ticket.

Enable Virtual-Hosted addressing

  1. In the control panel, in the top menu, click Products and select S3.
  2. Go to the Buckets section.
  3. Open the bucket page → Configuration tab.
  4. In the Addressing type section, 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).