Типы адресации

У бакета возможны два типа адресации:

Virtual-Hosted адресация (рекомендуемый);
Path-Style адресация.

Адресация выбирается при создании бакета. У бакета с Path-Style адресацией можно включить Virtual-Hosted адресацию. Изменить адресацию с Virtual-Hosted на Path-Style нельзя.

Посмотреть тип адресации созданного бакета можно в панели управления в разделе S3 → Бакеты → страница бакета → вкладка Конфигурация → блок Тип адресации.

Virtual-Hosted адресация

Virtual-Hosted адресация позволяет использовать CORS. При таком типе адресации название бакета указывается в начале URL: <bucket_name>.<s3_domain>, где <s3_domain> — домен S3 API в зависимости от пула.

Если у бакета включена Virtual-Hosted адресация, ее нельзя отключить.

Чтобы включение Virtual-Hosted адресации было возможным, имя бакета должно быть совместимо с S3 API:

быть уникальным среди бакетов всех пользователей, которые используют хранилище по S3 API и размещаются в том же пуле;
соответствовать правилам именования бакетов Amazon S3 — содержать только цифры, буквы латинского алфавита, символы . и -, подробнее в инструкции Bucket naming rules документации Amazon.

По умолчанию в проекте может быть не более 100 бакетов с Virtual-Hosted адресацией. Для увеличения количества таких бакетов создайте тикет.

Включить Virtual-Hosted адресацию

В панели управления в верхнем меню нажмите Продукты и выберите S3.
Перейдите в раздел Бакеты.
Откройте страницу бакета → вкладка Конфигурация.
В блоке Тип адресации выберите vHosted.
Нажмите Сохранить.

Path-Style адресация

При таком типе адресации название бакета указывается после URL: <s3_domain>/<bucket_name>, где <s3_domain> — домен S3 API в зависимости от пула.

При использовании Path-Style нельзя использовать CORS и могут быть ограничения при работе с инструментами, использующими S3 API (например, Cyberduck).