НОВЫЙPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Посмотреть список изменений →

Хранилище

Хранение файлов, работа с изображениями будет сделана за вас.

Пакеты, загрузки, подписанные ссылки и преобразование изображений «на лету» из того же SDK, что и ваши данные.

4
форматы вывода изображений
2,500 px
максимальный размер преобразования
storage.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
await aura.storage.createBucket('avatars', {
public: true,
fileSizeLimit: 5 * 1024 * 1024,
allowedMimeTypes: ['image/png', 'image/jpeg'],
})

Что включено

Все, что нужно файлу. От загрузки до миниатюры.

Организация

Ведра с правилами

Установите ограничение размера и разрешенные типы файлов для каждого сегмента.

Загрузить

Простые загрузки

Отправьте файл одним вызовом с перезаписью, когда захотите.

Скачать

Блоб или поток

Загрузите файл в виде BLOB-объекта или прочитайте его в виде потока.

Совместное использование

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

Поделитесь личным файлом с помощью ссылки, срок действия которой истекает через выбранное вами время.

Общественные ведра

Публично, когда вы этого захотите

Файлы в общедоступной корзине доступны любому пользователю без ключа API. Храните личные файлы в личном контейнере.

Изображения

Преобразование изображения «на лету»

Изменяйте размер, обрезайте и конвертируйте изображения в JPEG, PNG, WebP или GIF с параметрами URL. Результаты кэшируются на сервере.

Файлы

Копировать, перемещать и составлять список

Копируйте или перемещайте файлы внутри корзины, составляйте список по префиксу и читайте метаданные.

Безопасность

Корзина перед удалением

Удаление файла перемещает его в корзину. Для окончательного удаления требуется роль службы.

Серверная часть

Подписанные загрузки с вашего сервера

Создайте подписанные URL-адреса загрузки с ролью службы, чтобы клиенты могли загружать файлы, не сохраняя при этом ваши ключи.

Как это работает

Из файла в ссылку.

  1. 1

    Создать сегмент

    Выберите общедоступный или частный, ограничение размера и разрешенные типы.

  2. 2

    Загрузить

    Отправить файл; сервер возвращает свой ключ.

  3. 3

    Делиться

    Используйте общедоступный URL-адрес или подписанный URL-адрес, срок действия которого истекает.

  4. 4

    Трансформировать

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

REST API

Предпочитаете простой HTTP? Все это здесь.

SDK представляет собой тонкий слой над этими маршрутами. Отправляйте ключ API вашего проекта с каждым запросом.

МетодКонечная точкаОписание
GET/v1/storage/bucketsПеречислить ведра.
POST/v1/storage/bucketsСоздайте ведро.
PATCH/v1/storage/buckets/{id}Обновите настройки сегмента.
DELETE/v1/storage/buckets/{id}Удалить сегмент.
POST/v1/storage/{bucket}Загрузите файл с данными составной формы.
GET/v1/storage/{bucket}/{key}Загрузите файл, при необходимости преобразованный.
DELETE/v1/storage/{bucket}/{key}Удалить файл.
GET/v1/storage/{bucket}/meta/{key}Чтение метаданных файла.
POST/v1/storage/{bucket}/copyСкопируйте файл в корзину.
POST/v1/storage/{bucket}/moveПереместите файл в корзину.
GET/v1/storage/{bucket}/signed-urlСоздайте ограниченный по времени URL-адрес для загрузки.
GET/v1/storage/{bucket}/upload-urlСоздайте подписанный URL-адрес загрузки. Зарезервировано для роли службы.

Вопросы

Приятно знать.

Является ли общедоступное ведро действительно общедоступным?+
Да. Любой, у кого есть URL-адрес, может загрузить файлы без ключа API. Кладите в общедоступную корзину только то, что вы бы выложили в открытый доступ в Интернет.
Как мне на время поделиться личным файлом?+
Создайте подписанный URL-адрес с помощью createSignedUrl() и времени жизни в секундах. Ссылка перестает работать по истечении срока ее действия.
Насколько большим может быть преобразование изображения?+
Ширина и высота ограничены 2500 пикселями. Настройка качества применима только к JPEG.
Могу ли я скопировать файл в другую корзину?+
Еще нет. Копируйте и перемещайте работу внутри одной корзины.
Поддерживаются ли возобновляемые загрузки?+
Нет. Каждая загрузка представляет собой отдельный многочастный запрос, поэтому планируйте файлы, которые помещаются в один запрос.
Могу ли я отключить преобразование изображений?+
Да. Трансформации включены по умолчанию, и проект может их отключить. Запросы с преобразованием затем отклоняются.

Готовы хранить файлы?

Подарите своим файлам дом сегодня.

Хранение включено в каждый проект. Кредитная карта не требуется.