NEUPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Siehe Changelog →

Speicher

Dateispeicherung, die Bildbearbeitung wird für Sie erledigt.

Buckets, Uploads, signierte Links und spontane Bildtransformationen aus demselben SDK wie Ihre Daten.

4
Bildausgabeformate
2,500 px
maximale Transformationsgröße
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'],
})

Was ist enthalten?

Alles, was eine Datei braucht. Vom Upload bis zum Miniaturbild.

Organisation

Eimer mit Regeln

Legen Sie eine Größenbeschränkung und die zulässigen Dateitypen für jeden Bucket fest.

Hochladen

Einfache Uploads

Senden Sie eine Datei mit einem einzigen Aufruf und überschreiben Sie sie bei Bedarf.

Herunterladen

Blob oder Stream

Laden Sie eine Datei als Blob herunter oder lesen Sie sie als Stream.

Teilen

Signierte URLs

Teilen Sie eine private Datei mit einem Link, der nach der von Ihnen gewählten Zeit abläuft.

Öffentliche Eimer

Öffentlich, wenn Sie es sagen

Dateien in einem öffentlichen Bucket werden jedem ohne API-Schlüssel bereitgestellt. Bewahren Sie private Dateien in einem privaten Bucket auf.

Bilder

Bildtransformationen im laufenden Betrieb

Ändern Sie die Größe von Bildern, schneiden Sie sie zu und konvertieren Sie sie mit URL-Optionen in JPEG, PNG, WebP oder GIF. Die Ergebnisse werden auf dem Server zwischengespeichert.

Dateien

Kopieren, verschieben und auflisten

Kopieren oder verschieben Sie Dateien in einen Bucket, listen Sie sie nach Präfix auf und lesen Sie Metadaten.

Sicherheit

Papierkorb vor dem Löschen

Durch das Entfernen einer Datei wird diese in den Papierkorb verschoben. Für das dauerhafte Löschen ist die Servicerolle erforderlich.

Serverseitig

Signierte Uploads von Ihrem Server

Erstellen Sie signierte Upload-URLs mit der Servicerolle, damit Kunden Uploads durchführen können, ohne Ihre Schlüssel zu besitzen.

Wie es funktioniert

Von einer Datei zu einem Link.

  1. 1

    Erstellen Sie einen Eimer

    Wählen Sie „öffentlich“ oder „privat“, eine Größenbeschränkung und zulässige Typen.

  2. 2

    Hochladen

    Senden Sie die Datei; Der Server gibt seinen Schlüssel zurück.

  3. 3

    Teilen

    Verwenden Sie eine öffentliche URL oder eine signierte URL, die abläuft.

  4. 4

    Verwandeln

    Fügen Sie der URL Breite, Höhe oder Format hinzu, um ein abgeleitetes Bild zu erhalten.

REST-API

Bevorzugen Sie einfaches HTTP? Es ist alles hier.

Das SDK ist eine dünne Schicht über diesen Routen. Senden Sie bei jeder Anfrage den API-Schlüssel Ihres Projekts.

MethodeEndpunktBeschreibung
GET/v1/storage/bucketsBuckets auflisten.
POST/v1/storage/bucketsErstellen Sie einen Eimer.
PATCH/v1/storage/buckets/{id}Aktualisieren Sie die Einstellungen eines Buckets.
DELETE/v1/storage/buckets/{id}Löschen Sie einen Bucket.
POST/v1/storage/{bucket}Laden Sie eine Datei mit mehrteiligen Formulardaten hoch.
GET/v1/storage/{bucket}/{key}Laden Sie eine Datei herunter, optional transformiert.
DELETE/v1/storage/{bucket}/{key}Eine Datei löschen.
GET/v1/storage/{bucket}/meta/{key}Lesen Sie die Metadaten einer Datei.
POST/v1/storage/{bucket}/copyKopieren Sie eine Datei in ihren Bucket.
POST/v1/storage/{bucket}/moveVerschieben Sie eine Datei in ihren Bucket.
GET/v1/storage/{bucket}/signed-urlErstellen Sie eine zeitlich begrenzte Download-URL.
GET/v1/storage/{bucket}/upload-urlErstellen Sie eine signierte Upload-URL. Reserviert für die Servicerolle.

Fragen

Gut zu wissen.

Ist ein öffentlicher Bucket wirklich öffentlich?+
Ja. Jeder mit der URL kann seine Dateien ohne API-Schlüssel herunterladen. Geben Sie nur das in einen öffentlichen Eimer, was Sie auch ins offene Internet stellen würden.
Wie teile ich eine private Datei für eine Weile?+
Erstellen Sie eine signierte URL mit createSignedUrl() und einer Lebensdauer in Sekunden. Der Link funktioniert nicht mehr, wenn er abläuft.
Wie groß kann eine Bildtransformation sein?+
Breite und Höhe sind auf 2.500 Pixel begrenzt. Die Qualitätseinstellung gilt nur für JPEG.
Kann ich eine Datei in einen anderen Bucket kopieren?+
Noch nicht. Kopieren und verschieben Sie Arbeit in einen einzigen Bucket.
Werden fortsetzbare Uploads unterstützt?+
Nein. Bei jedem Upload handelt es sich um eine einzelne mehrteilige Anfrage. Planen Sie daher Dateien ein, die in eine Anfrage passen.
Kann ich Bildtransformationen deaktivieren?+
Ja. Transformationen sind standardmäßig aktiviert und können von einem Projekt deaktiviert werden. Anfragen mit einer Transformation werden dann abgelehnt.

Bereit zum Speichern von Dateien?

Geben Sie Ihren Dateien noch heute ein Zuhause.

Die Speicherung ist in jedem Projekt enthalten. Keine Kreditkarte erforderlich.