Модели адресации в S3

На данный момент поддерживаются две модели адресации для доступа к объектному хранилищу S3:

  • Path-style — модель, при которой название бакета указывается в части пути до объекта в URI (URI path), например: https://b2.s3.sbercloud.ru/TESTBUCKET/myobject.txt

  • Virtual-hosted style — модель, при которой название бакета включается в адрес хоста (hostname), например: https://TESTBUCKET.b2.s3.sbercloud.ru/myobject.txt

Примечание

Разработчик протокола S3 планирует со временем отказаться от поддержки модели Path-style и поддерживать только Virtual-hosted style.

В этой связи все больше продуктов и приложений для работы с S3-хранилищами (Veeam, Cyberduck и др.) переходят на использование адресной модели Virtual-hosted style.

Правила адресации для приватных и публичных бакетов

Для бакетов с приватным доступом поддерживаются обе модели адресации — Path-style и Virtual-hosted style.

Для бакетов с публичным доступом поддерживается только модель Path-style. При этом для доступа к публичным бакетам необходимо использовать альтернативный эндпоинт.

Примечание

Подробнее о приватном и публичном доступах к бакету — в статье.

В таблице приведены форматы эндпоинтов для приватного и публичного доступа к бакетам в разных зонах доступности.

Зона доступности Назначение Формат эндпоинта
PD01 Эндпоинт для приватного доступа Path-style: a1.s3.sbercloud.ru

Virtual-hosted style: [bucket_name].a1.s3.sbercloud.ru
Эндпоинт для публичного доступа [namespace].s3pd01.sbercloud.ru
PD02 Эндпоинт для приватного доступа Path-style: a2.s3.sbercloud.ru

Virtual-hosted style: [bucket_name].a2.s3.sbercloud.ru
Эндпоинт для публичного доступа [namespace].s3pd02.sbercloud.ru
PD11 Эндпоинт для приватного доступа Path-style: b1.s3.sbercloud.ru

Virtual-hosted style: [bucket_name].b1.s3.sbercloud.ru
Эндпоинт для публичного доступа [namespace].s3pd11.sbercloud.ru
PD12 Эндпоинт для приватного доступа Path-style: b2.s3.sbercloud.ru

Virtual-hosted style: [bucket_name].b2.s3.sbercloud.ru
Эндпоинт для публичного доступа [namespace].s3pd12.sbercloud.ru
PD11-12 (геокластер) Эндпоинт для приватного доступа Path-style: b.s3.sbercloud.ru

Virtual-hosted style: [bucket_name].b.s3.sbercloud.ru
Эндпоинт для публичного доступа [namespace].s3pdgeob.sbercloud.ru

Пример формирования URL для подключения к бакету

  • Название бакета: testbucket

  • Название объекта: myobject.txt

  • Зона доступности: PD12

  • Namespace: testnamespace

Path-style URL для приватного доступа: https://b2.s3.sbercloud.ru/testbucket/myobject.txt

Virtual-hosted style URL для приватного доступа: https://testbucket.b2.s3.sbercloud.ru/myobject.txt

Path-style URL для публичного доступа: https://testnamespace.s3pd12.sbercloud.ru/testbucket/myobject.txt

Примечание

В названии файлов следует использовать символы латиницы, так как поддерживается только кодировка ISO-8859-1.

Запустили Evolution free tier
для Dev & Test
Получить