Модели адресации в 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. При этом для доступа к публичным корзинам необходимо использовать альтернативный Endpoint.

Примечание

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

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

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

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

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

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

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

Virtual-hosted style: [bucket_name].b.s3.sbercloud.ru
Endpoint для публичного доступа [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