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 · Использование доменов
Загрузка…