Tovanix
Tovanix

API объектного хранилища

Объектное хранилище, совместимое с S3. Выпускайте отдельные ключи для каждого бакета, подключайте любой S3 SDK напрямую и не платите за исходящий трафик при чтении.

  • Доступ: Access Key / Secret Key выпускаются для конкретного бакета и действуют только для него. Секрет показывается один раз, новый ключ активируется примерно через минуту
  • Настройка SDK: регион всегда auto, адресация через виртуальный хост. Примеры Node.js / Python / Go / PHP / aws-cli
  • CORS: необходим для прямой загрузки или чтения из браузера; источник должен быть конкретным доменом, без маски
  • Предподписанные URL: доступны для загрузки и скачивания, чтобы передавать браузеру временную ссылку вместо ключа
  • Лимиты и цены: 5 GiB для одного PUT и до 10000 частей при составной загрузке. Хранение оплачивается по фактическому суточному использованию; удаление и исходящий трафик бесплатны

Обзор

S3-совместимое объектное хранилище. Создавайте учётные данные для каждого бакета, подключайте любой SDK S3 и не платите за исходящий трафик.

Существующие настройки aws-sdk, boto3, s3cmd или rclone продолжают работать: замените адрес и установите region в auto.

Учётные данные

Создавайте их для каждого бакета в разделе Объектное хранилище → Бакеты → Ключи. Учётные данные ограничены этим бакетом и не дают доступа к остальным.

  • Endpoint — Адрес S3, например https://<account>.r2.cloudflarestorage.com
  • Bucket — Фактическое имя бакета (с префиксом платформы, отличается от выбранного вами псевдонима)
  • Access Key ID — Access Key ID
  • Secret Access Key — Secret Access Key — показывается только один раз при создании
  • Region — Всегда auto. us-east-1 и подобные значения нарушают подпись, и каждый запрос возвращает 403 SignatureDoesNotMatch

Новые учётные данные распространяются на узлы хранилища около минуты; до этого вызовы возвращают 401 Unauthorized. Ключ не ошибочный: подождите и повторите. При первом подключении это легко принять за другую проблему.

Мы не храним Secret Access Key, поэтому после закрытия окна получить его нельзя. При потере придётся удалить ключ и создать новый, временно нарушив действующее подключение; сразу сохраните его в менеджере секретов.

Настройка SDK

Подставьте четыре значения из консоли в используемый SDK S3.

Используйте virtual-host (по умолчанию), не включайте path-style. Ошибка приводит к 404 / NoSuchBucket и выглядит как опечатка в имени бакета.

CORS

Браузер может обращаться к бакету напрямую (загрузка или чтение из интерфейса) только после настройки CORS. Иначе запрос блокируется ещё до отправки: ошибка CORS в консоли, на сервере ничего. Настройте в разделе Бакеты → Настройки → CORS.

Звёздочка позволяет любому сайту читать и записывать в бакет с учётными данными посетителей, не оставляя доступного для проверки следа доступа. Укажите конкретные домены.

Предподписанные URL

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

Ограничения

  • 5 GiB на один PUT; для больших файлов используйте multipart-загрузку
  • До примерно 4,995 TiB на объект через multipart, максимум 10 000 частей
  • Ключи объектов до 1024 байт
  • Одна одновременная запись в секунду на один ключ объекта

Тарифы

Без доплат в пределах объёма тарифа; при превышении действуют следующие расценки.

  • Хранилище — $0.03 / GB·месяц — Оплата по фактическому суточному использованию, а не по пику
  • $9.00 / 1M — Операции записи и получения списка (PutObject, ListObjects, multipart, …)
  • $0.72 / 1M — Операции чтения (GetObject, HeadObject, …)
  • Исходящий трафик — Бесплатно — Чтение не оплачивается за трафик — главное отличие в стоимости от традиционного объектного хранилища
  • Удаление — Бесплатно — Удаление объектов и бакетов, а также отмена multipart-загрузок бесплатны

Дешевле за GB, но с минимальным сроком хранения 30 дней (при раннем удалении оплачиваются все 30 дней) и платой за каждое чтение. При ежедневном чтении бакета счёт растёт; класс подходит для архивов и резервных копий с частой записью и редким чтением.

Часто задаваемые вопросы

Почему новые ключи доступа продолжают возвращать 401?

Новым ключам требуется примерно минута для распространения на узлы хранилища. В это время запросы возвращают 401 Unauthorized. Это не означает неверный ключ: немного подождите и повторите запрос. При первой интеграции эту ситуацию легко принять за другую ошибку.

Какой регион использовать и почему возникает SignatureDoesNotMatch?

Регион всегда auto. Значение us-east-1 или подобное нарушает подпись, и каждый запрос возвращает 403 SignatureDoesNotMatch. Используйте адресацию через виртуальный хост, не включайте стиль пути: эта ошибка вызывает 404 NoSuchBucket.

Связанные страницы: Документация API · Облачные сервисы Tovanix · Использование доменов

Загрузка…