Управление бакетами

В настоящий момент мы поддерживаем два кластера S3, которые немного отличаются доступными возможностями и методами. Если какой-то функционал, описанный в документации, недоступен для вашего аккаунта, но необходим вам для работы — мы можем перевести ваш аккаунт на другой кластер, по запросу в поддержку.

Подключение к бакету и работа с файлами

Оба кластера нашего хранилища S3 поддерживают доступ через Amazon S3 API и Swift API. При этом, для одного из кластеров реквизиты подключения для S3 и Swift совпадают. Для другого кластера реквизиты разделены, и в этом случае в настройках бакета в панели будут отдельно отображены «Параметры Swift».

Подключение к хранилищу и управление файлами (загрузка, удаление, изменение) может быть реализовано разными способами:

• Вы можете использовать клиент API S3. Это может быть файловый менеджер Cyberduck или любой другой инструмент с поддержкой протокола S3, например, S3cmd, Rclone, AWS CLI, S3 Browser и многие другие.
• Подключение к хранилищу может быть реализовано в коде вашего приложения, с помощью библиотек языка программирования для протокола S3. Примеры можно найти здесь.
• Загружать файлы в бакет можно с помощью объектного менеджера в панели управления.
• Можно подключаться к бакету с помощью ispmanager для автоматической загрузки бэкапов.
• Можно настроить выгрузку бэкапов в хранилище через Bitrix Backup — для этого необходима версия AWS Signature v2, доступная в кластере s3.timeweb.cloud. По запросу мы можем перевести ваш аккаунт на нужный кластер.

Один из наших кластеров хранилища (эндпойнт s3.timeweb.com) поддерживает только AWS Signature v4, второй (эндпойнт s3.timeweb.cloud) — версии v2 и v4. Клиент S3 может использовать другую версию Signature, поэтому возможны ошибки подключения.

Например, в клиенте S3 Browser можно выставить в настройках использование AWS Signature v4 вместо v2.

Реквизиты подключения доступны в блоке «Параметры S3» в настройках бакета. 

В зависимости от кластера, URL может быть s3.timeweb.com или s3.timeweb.cloud. Проверить корректные ссылки всегда можно в вашей панели в настройках бакета.

Для доступа к файлам используются пути вида:

https://s3.timeweb.com/имя_бакета/имя_файла
https://s3.timeweb.cloud/имя_бакета/имя_файла

Либо, если файл размещен внутри директории в бакете:

https://s3.timeweb.com/имя_бакета/имя_директории/имя_файла
https://s3.timeweb.cloud/имя_бакета/имя_директории/имя_файла

К файлам в публичных бакетах также можно обращаться, используя модель адресации Virtual-hosted style, в этом случае название бакета входит в имя хоста:

https://имя_бакета.s3.timeweb.com/имя_файла
https://имя_бакета.s3.timeweb.com/имя_директории/имя_файла

https://имя_бакета.s3.timeweb.cloud/имя_файла
https://имя_бакета.s3.timeweb.cloud/имя_директории/имя_файла

Вы также можете обращаться к бакету по своему домену, привязав его.

Получить доступ к файлам в публичном бакете можно через браузер или другой HTTP-клиент, обратившись непосредственно по такой ссылке.

Доступ к файлам в приватном бакете также может быть организован через HTTP, но дополнительно потребуется подпись для аутентификации, которая добавляется к запросу в виде HTTP-заголовков. Подробнее см. Описание принципов работы с S3.

Скорость загрузки файлов в бакет или из бакета составляет 1 Гбит/сек.

Смена тарифа

Вы можете увеличить тариф бакета, если вам потребуется больше пространства для хранения данных. Изменить тариф в меньшую сторону невозможно.

Для смены тарифа кликните на нужный бакет в панели управления, чтобы открыть настройки, и нажмите «Изменить размер хранилища».

Выберите новый тариф и сохраните изменения. 

Объем пространства увеличится сразу же.

История действий

Вы можете просмотреть, какие действия выполнялись с бакетом, на вкладке «История».

Логируются следующие события:

• Создание бакета
• Изменение конфигурации
• Привязка домена
• Выпуск SSL-сертификата на домен
• Перенос данных
• Удаление бакета

Удаление бакета

Будет удален бакет и все файлы в нем. 

Для удаления кликните на три точки на вкладке Бакеты:

Либо на значок удаления в настройках бакета:

Во всплывающем окне введите имя бакета или код подтверждения, в зависимости от ваших настроек.