Tovanix
Tovanix

Использование объектного хранилища

Как подключить объектное хранилище 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 объектного хранилища

Загрузка…