NOWYPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Zobacz dziennik zmian →

Przechowywanie plików

Przechowywanie plików i praca z obrazami wykonywana za Ciebie.

Zasobniki, przesyłanie, podpisane linki i transformacje obrazów w locie z tego samego pakietu SDK, co Twoje dane.

4
formaty wyjściowe obrazu
2,500 px
maksymalny rozmiar transformacji
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'],
})

Co jest wliczone w cenę

Wszystko, czego potrzebuje plik. Od przesłania do miniatury.

Organizacja

Wiadra z zasadami

Ustaw limit rozmiaru i dozwolone typy plików w każdym segmencie.

Wgrywać

Proste przesyłanie

Wyślij plik jednym wywołaniem i nadpisz, kiedy chcesz.

Pobierać

Kropla lub strumień

Pobierz plik jako obiekt BLOB lub odczytaj go jako strumień.

Partycypujący

Podpisane adresy URL

Udostępnij prywatny plik z linkiem, który wygasa po wybranym przez Ciebie czasie.

Wiadra publiczne

Publicznie, kiedy tak mówisz

Pliki w zasobniku publicznym są udostępniane każdemu, bez klucza API. Przechowuj prywatne pliki w prywatnym wiadrze.

Obrazy

Obraz zmienia się w locie

Zmieniaj rozmiar, przycinaj i konwertuj obrazy do formatu JPEG, PNG, WebP lub GIF za pomocą opcji adresu URL. Wyniki są buforowane na serwerze.

Akta

Kopiuj, przenoś i wyświetlaj

Kopiuj lub przenoś pliki w zasobniku, sortuj według prefiksów i czytaj metadane.

Bezpieczeństwo

Kosz przed usunięciem

Usunięcie pliku powoduje przeniesienie go do kosza. Trwałe usunięcie wymaga roli usługi.

Po stronie serwera

Podpisane pliki przesyłane z Twojego serwera

Utwórz podpisane adresy URL przesyłania z rolą usługi, aby klienci mogli przesyłać pliki bez konieczności trzymania kluczy.

Jak to działa

Od pliku do łącza.

  1. 1

    Utwórz wiadro

    Wybierz publiczny lub prywatny, limit rozmiaru i dozwolone typy.

  2. 2

    Wgrywać

    Wyślij plik; serwer zwraca swój klucz.

  3. 3

    Udział

    Użyj publicznego adresu URL lub podpisanego adresu URL, który wygasa.

  4. 4

    Przekształcać

    Dodaj szerokość, wysokość lub format do adresu URL, aby uzyskać obraz pochodny.

API REST

Wolisz zwykły HTTP? To wszystko jest tutaj.

Zestaw SDK to cienka warstwa na tych trasach. Przy każdym żądaniu wysyłaj klucz API swojego projektu.

MetodaPunkt końcowyOpis
GET/v1/storage/bucketsLista wiader.
POST/v1/storage/bucketsUtwórz wiadro.
PATCH/v1/storage/buckets/{id}Zaktualizuj ustawienia zasobnika.
DELETE/v1/storage/buckets/{id}Usuń wiadro.
POST/v1/storage/{bucket}Prześlij plik z wieloczęściowymi danymi formularza.
GET/v1/storage/{bucket}/{key}Pobierz plik, opcjonalnie przekształcony.
DELETE/v1/storage/{bucket}/{key}Usuń plik.
GET/v1/storage/{bucket}/meta/{key}Przeczytaj metadane pliku.
POST/v1/storage/{bucket}/copySkopiuj plik do jego segmentu.
POST/v1/storage/{bucket}/movePrzenieś plik do jego segmentu.
GET/v1/storage/{bucket}/signed-urlUtwórz ograniczony czasowo adres URL pobierania.
GET/v1/storage/{bucket}/upload-urlUtwórz podpisany adres URL przesyłania. Zarezerwowany do roli usługowej.

Pytania

Dobrze wiedzieć.

Czy wiadro publiczne jest naprawdę publiczne?+
Tak. Każdy, kto ma adres URL, może pobrać jego pliki bez klucza API. Do publicznego wiadra wrzucaj tylko to, co umieściłbyś w otwartym Internecie.
Jak udostępnić na jakiś czas prywatny plik?+
Utwórz podpisany adres URL za pomocą createSignedUrl() i czasu życia w sekundach. Link przestaje działać po wygaśnięciu.
Jak duża może być transformacja obrazu?+
Szerokość i wysokość są ograniczone do 2500 pikseli. Ustawienie jakości dotyczy wyłącznie plików JPEG.
Czy mogę skopiować plik do innego zasobnika?+
Jeszcze nie. Kopiuj i przenoś pracę w jednym wiadrze.
Czy obsługiwane jest przesyłanie wznawiane?+
Nie. Każde przesłanie to pojedyncze, wieloczęściowe żądanie, dlatego należy zaplanować pliki, które zmieszczą się w jednym żądaniu.
Czy mogę wyłączyć transformację obrazu?+
Tak. Transformacje są domyślnie włączone i projekt może je wyłączyć. Żądania z transformacją są wówczas odrzucane.

Gotowy do przechowywania plików?

Już dziś zapewnij swoim plikom dom.

Przechowywanie jest uwzględnione w każdym projekcie. Nie jest wymagana karta kredytowa.