Использование объектного хранилища
Как подключить объектное хранилище Tovanix и пользоваться им:
- Совместимо с S3, исходящий трафик отдельно не оплачивается; подписка оформляется на аккаунт, месячная плата включает определённый объём хранения и число запросов, а превышение ежедневно списывается с баланса.
- При создании бакета выбираются местоположение и класс хранения, а система автоматически добавляет к имени префикс для глобальной уникальности.
- Для каждого бакета можно выпустить несколько ключей доступа «Только чтение» или «Чтение и запись»; Secret показывается только один раз, а новому ключу нужно время на распространение.
- В консоли можно загружать и скачивать файлы, большие файлы автоматически загружаются частями; настраиваются публичный доступ, CORS, жизненный цикл, перенос и блокировка.
- С дня окончания срока бакеты переходят в режим только для чтения, а выпущенные ключи отзываются; если подписка не продлена в течение 7 дней после окончания срока, данные очищаются и удаляются.
Что это и как оплачивается
Объектное хранилище совместимо с S3: для каждого бакета выпускаются отдельные ключи доступа, к нему можно сразу подключить существующие SDK и инструменты для S3, а исходящий трафик отдельно не оплачивается. В разделе «Облачный сервис → Бакеты» выберите срок (1, 3, 6 или 12 месяцев) и нажмите «Включить сейчас»; подписка оформляется на аккаунт, и после подключения можно создать несколько бакетов.
- Месячная плата включает определённый объём хранения и число запросов в месяц, а число бакетов ограничено; превышение оплачивается по объёму хранения и числу запросов (классов A и B). Конкретные значения указаны на странице подключения.
- Использование собирается раз в сутки (по суткам UTC); «Перерасход за месяц (оценка)» рассчитывается по уже собранным данным и не включает месячную плату.
- Превышение ежедневно списывается с баланса аккаунта, поэтому баланс может уйти в минус — в этом случае придёт уведомление; следите, чтобы средств хватало.
Создание бакета
На странице «Бакеты» нажмите «Создать бакет»: имя может содержать только строчные буквы, цифры и дефисы, система автоматически добавит к нему префикс для глобальной уникальности, но вы всегда видите своё имя; местоположение можно выбрать «Автоматически» (система подберёт ближайшее) или указать регион; класс хранения — «Стандартный» или «Редкий доступ».
В списке бакетов показаны занятый объём, местоположение и класс хранения каждого бакета. Нажмите на имя, чтобы открыть подробности, — они разделены на четыре вкладки: «Объекты», «Ключи доступа», «Показатели» и «Настройки».
Ключи доступа
- На вкладке «Ключи доступа» бакета нажмите «Выпустить ключ» и выберите права «Чтение и запись» или «Только чтение». Выпущенный ключ даёт доступ только к этому бакету, его можно указать в любом SDK или инструменте для S3, а для одного бакета можно выпустить несколько ключей.
- Secret Access Key показывается только один раз при выпуске и после закрытия окна больше недоступен — сразу скопируйте и сохраните его; можно также нажать «Скопировать как конфигурацию».
- Новому ключу нужно время, чтобы распространиться на узлы хранения, — страница покажет примерно сколько секунд; в это время вызовы возвращают 401, и это не значит, что ключ указан неверно, — просто повторите попытку чуть позже.
- В блоке «Общее» вкладки «Настройки» бакета указаны S3-эндпоинт и полное имя бакета — они понадобятся при подключении; ключи, которые больше не нужны, можно «Отозвать». Способы подключения и примеры кода — в документации API объектного хранилища (/docs/objstore).
Управление файлами в консоли
На вкладке «Объекты» бакета можно создать «Новую папку», «Загрузить» файлы или «Загрузить папку», а также скачивать, копировать ссылки, удалять и фильтровать по префиксу имени; большие файлы автоматически загружаются частями, путь файла — не длиннее 1024 байт. Несколько файлов или папок можно отметить и удалить вместе.
При первом открытии бакета нужно подготовить временные учётные данные доступа — это занимает около полуминуты, после чего работа продолжится автоматически. Вкладка «Показатели» показывает использование этого бакета, данные обновляются раз в сутки, а у нового бакета они появляются только на следующий день.
Настройки бакета
Вкладка «Настройки» бакета состоит из следующих разделов:
- Общее — Полное имя бакета, S3-эндпоинт, местоположение, класс хранения и дата создания.
- Публичный доступ — При включении все объекты бакета может публично читать кто угодно. «Публичный URL разработки» подходит только для тестов — для рабочего использования привяжите «Собственный домен»; привязать можно только принадлежащий вам домен, DNS которого обслуживается платформой.
- CORS — CORS нужно настроить, если веб-страницы обращаются к бакету напрямую (загрузка и чтение прямо из фронтенда); в источнике нельзя указывать подстановочный знак *.
- Жизненный цикл — Автоматическое удаление объектов или перевод в класс «Редкий доступ» по префиксу и числу дней, а также очистка незавершённых составных загрузок; рекомендуем добавить в каждый бакет правило очистки незавершённых загрузок.
- Перенос — Постепенный перенос данных из вашего S3-бакета в другом месте по мере обращений: когда запрашивается файл, которого ещё нет в этом бакете, он в реальном времени забирается из исходного бакета и сохраняется здесь — без простоя. Нужно указать имя исходного бакета, регион и ключ доступа, достаточно прав только на чтение; платформа использует этот ключ только для чтения исходного бакета и не сохраняет его. Перенесённые данные занимают место в этом бакете и учитываются в числе запросов; после отключения переноса уже перенесённые файлы остаются в этом бакете.
- Блокировка — В течение срока хранения файлы с подходящим префиксом нельзя удалить или перезаписать — ни вам, ни поддержке платформы, а оплата всё это время начисляется как обычно. Срок задаётся в днях, максимальное число дней указано на странице, бессрочной блокировки нет.
- Незавершённые загрузки — Если загрузка большого файла прервалась, уже загруженные части остаются: они оплачиваются как хранение, но не видны в списке файлов; здесь их можно посмотреть и удалить части старше 24 часов.
- Опасная зона — «Очистить бакет» удаляет все файлы в бакете без возможности восстановления; перед удалением бакета его обязательно нужно очистить, а при удалении все ключи этого бакета отзываются.
Продление и окончание срока
- На странице «Бакеты» нажмите «Продлить», выберите срок и оплатите. Автопродления пока нет, перед окончанием срока платформа присылает напоминание.
- С дня окончания срока бакеты переходят в режим только для чтения: их по-прежнему можно просматривать, скачивать файлы, удалять и очищать, но нельзя загружать файлы, менять настройки, создавать новые бакеты и выпускать новые ключи.
- После окончания срока выпущенные ключи доступа отзываются, а после продления их нужно выпустить заново.
Если подписка не продлена в течение 7 дней после окончания срока, платформа очищает бакеты и удаляет данные без возможности восстановления, а после удаления присылает уведомление. Нужные данные скачайте или продлите подписку до этого момента.
Устранение проблем
- Вызовы с только что выпущенным ключом возвращают 401 — Новый ключ ещё распространяется на узлы хранения — Подождите, как подсказывает страница, и повторите попытку, не пересоздавайте ключ снова и снова.
- В счетах есть плата за хранение, а файлов в бакете гораздо меньше — Остались части прерванных загрузок, которые не видны в списке файлов — Посмотрите и удалите их в разделе «Настройки → Незавершённые загрузки».
- Не удаётся удалить бакет — В бакете ещё есть файлы, или часть файлов находится в сроке блокировки — Сначала нажмите «Очистить бакет»; если появилось сообщение о блокировке, проверьте правила в разделе «Настройки → Блокировка» — файлы в сроке хранения можно удалить только после его окончания.
- При открытии бакета сообщается, что готовятся временные учётные данные доступа — При первом открытии нужно подготовить временные учётные данные — Это занимает около полуминуты, после чего работа продолжится автоматически — обновлять страницу не нужно.
- Сообщается, что достигнут лимит числа бакетов — Число ваших бакетов достигло лимита — Удалите ненужные бакеты и создайте новый.
- Баланс аккаунта стал отрицательным — Превышение включённого объёма ежедневно списывается с баланса — Пополните баланс; оценку перерасхода за текущий месяц можно посмотреть на странице «Бакеты».
Часто задаваемые вопросы
Оплачивается ли трафик при скачивании файлов?
Нет, исходящий трафик отдельно не оплачивается. Вы платите месячную плату, а также за объём хранения и запросы сверх включённого объёма.
Удаляются ли данные сразу после окончания срока?
Нет. С дня окончания срока бакеты переходят в режим только для чтения, данные можно скачать и удалить; очищаются и удаляются без возможности восстановления они, только если подписка не продлена в течение 7 дней после окончания срока.
Что делать, если Secret Access Key потерян?
Он показывается только один раз при выпуске, и восстановить его нельзя. Отзовите старый ключ и выпустите новый.
Связанные страницы: Центр помощи · Руководства и вопросы · S3-совместимое объектное хранилище · API объектного хранилища
Загрузка…