Skip to main content

Addressing types

Last update:

Two types of addressing are possible in a bucktree:

Addressing is selected when creating the bucket. A buckets with Path-Style addressing can have Virtual-Hosted addressing enabled. You cannot change the addressing from Virtual-Hosted to Path-Style.

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

Virtual-Hosted addressing

Virtual-Hosted addressing allows the use of CORS.With this type of addressing, 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 the bucket has Virtual-Hosted addressing enabled, it cannot be disabled.

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

  • be unique among all users who use the storage by S3 and are placed in the same pool;
  • comply with Amazon S3 Bucket naming rules — contain only numbers, letters of the Latin alphabet, symbols . and -, for more information see the Bucket naming rules in the Amazon documentation.

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

Enable Virtual-Hosted addressing

  1. In the control panel, on the top menu, click Products and select S3.
  2. Go to the Buckets section.
  3. Open the baket page → Configuration tab.
  4. In the Addressing Type block, select vHosted.
  5. Click Save.

Path-Style addressing

With this type of addressing, 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 (e.g. Cyberduck).