Облачная платформаEvolution

Модели адресации в Object Storage

Эта статья полезна?

Обращение к бакету происходит по адресу, который содержит домен хранилища и название бакета. Для одного бакета можно настроить несколько адресов и использовать каждый из них в зависимости от настроек бакета и типа запроса к хранилищу — авторизованного или анонимного. Адреса отличаются типом названия бакета, доменом хранилища и моделью адресации.

Тип названия бакета

Модель адресации

Обязательное

Подходит для анонимных запросов

Подходит для статических сайтов s3-website

Адрес для обращения

Базовое название бакета, соответствует полю Название в личном кабинете

Path-Style — название указывается в пути адреса с доменом s3.cloud.ru

Да

https://s3.cloud.ru/bucket-name

Глобальное название

Path-Style — глобальное название указывается в пути адреса с доменом global.s3.cloud.ru

Да

https://global.s3.cloud.ru/global-bucket-name

Доменное имя

Virtual-Hosted-Style — доменное имя указывается в адресе как поддомен

Да

Да

  • https://dns-bucket-name.s3-website.cloud.ru — адрес для обращений к статическому сайту, данные которого размещены в бакете;

  • https://dns-bucket-name.s3.cloud.ru — адрес для любых других обращений.

Выбор названия и модели адресации

Выбор адреса и типа названия бакета зависит от сценария использования хранилища:

  • Для работы с хранилищем через авторизованные запросы допустимо использовать любой тип названия бакета.

  • Для анонимных запросов подойдут глобальное название или доменное имя бакета.

  • Если хранилище используется для хостинга статического сайта s3-website, бакету нужно назначить доменное имя — оно будет использоваться для обращения к страницам сайта.

Примечание

При управлении хранилищем через клиенты для работы с AWS S3 API убедитесь, что выбранный тип названия соответствует домену и модели адресации, которые установлены в конфигурации клиентского приложения. Чтобы упростить работу в клиенте, рекомендуется задать для бакета доменное имя, аналогичное базовому названию бакета — так к хранилищу можно будет обращаться по моделям Path-Style и Virtual-Hosted-Style с использованием одного и того же названия.

Настройка названий бакета

В таблице представлены правила настройки названий бакета.

Тип названия

Как задается

Требования

Базовое название

При создании бакета в любом инструменте: личном кабинете, AWS S3 API или стороннем клиенте. После создания бакета изменить название нельзя.

  • длина от 3 до 63 символов;

  • начинается и заканчивается буквой или цифрой;

  • содержит только строчные буквы латинского алфавита, цифры, точки или дефисы;

  • не содержит двух и более точек подряд;

  • не содержит префикс xn--;

  • отличается от IP-адреса или схожего форматирования;

  • уникально в рамках тенанта.

Глобальное название

  • длина от 3 до 63 символов;

  • начинается и заканчивается буквой или цифрой;

  • содержит только строчные буквы латинского алфавита, цифры, точки или дефисы;

  • не содержит двух и более точек подряд;

  • не содержит префикс xn--;

  • отличается от IP-адреса или схожего форматирования;

  • уникально среди всех глобальных названий Object Storage.

Доменное имя

При создании бакета напрямую через AWS S3 API можно задать для бакета доменное имя, которое будет совпадать с базовым названием.

  • длина от 3 до 63 символов;

  • начинается и заканчивается буквой или цифрой;

  • содержит только строчные буквы латинского алфавита, цифры или дефисы;

  • не содержит префикс xn--;

  • отличается от IP-адреса или схожего форматирования;

  • уникально среди всех доменных имен Object Storage.