NOUVEAUPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Voir le changelog →

Stockage

Stockage de fichiers, avec le travail d’image effectué pour vous.

Buckets, téléchargements, liens signés et transformations d’images à la volée, à partir du même SDK que vos données.

4
formats de sortie d’images
2,500 px
taille de transformation maximale
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'],
})

Ce qui est inclus

Tout ce dont un fichier a besoin. Du téléchargement à la vignette.

Organisation

Seaux avec règles

Définissez une limite de taille et les types de fichiers autorisés sur chaque compartiment.

Télécharger

Téléchargements simples

Envoyez un fichier en un seul appel, avec écrasement quand vous le souhaitez.

Télécharger

Blob ou flux

Téléchargez un fichier sous forme de Blob ou lisez-le sous forme de flux.

Partage

URL signées

Partagez un fichier privé avec un lien qui expire après l’heure que vous choisissez.

Compartiments publics

Public quand vous le souhaitez

Les fichiers d’un compartiment public sont servis à n’importe qui, sans clé API. Conservez les fichiers privés dans un compartiment privé.

Images

Transformations d’images à la volée

Redimensionnez, recadrez et convertissez les images au format JPEG, PNG, WebP ou GIF avec les options d’URL. Les résultats sont mis en cache sur le serveur.

Fichiers

Copier, déplacer et lister

Copiez ou déplacez des fichiers dans un compartiment, répertoriez-les par préfixe et lisez les métadonnées.

Sécurité

Corbeille avant suppression

La suppression d’un fichier le déplace vers la corbeille. La suppression définitive nécessite le rôle de service.

Côté serveur

Téléchargements signés depuis votre serveur

Créez des URL de téléchargement signées avec le rôle de service afin que les clients puissent télécharger sans détenir vos clés.

Comment ça marche

D’un fichier à un lien.

  1. 1

    Créer un compartiment

    Choisissez public ou privé, une limite de taille et les types autorisés.

  2. 2

    Télécharger

    Envoyez le fichier ; le serveur renvoie sa clé.

  3. 3

    Partager

    Utilisez une URL publique ou une URL signée qui expire.

  4. 4

    Transformer

    Ajoutez de la largeur, de la hauteur ou du format à l’URL pour obtenir une image dérivée.

API REST

Vous préférez le HTTP simple ? Tout est ici.

Le SDK constitue une fine couche sur ces routes. Envoyez la clé API de votre projet avec chaque demande.

MéthodePoint de terminaisonDescriptif
GET/v1/storage/bucketsRépertoriez les compartiments.
POST/v1/storage/bucketsCréez un compartiment.
PATCH/v1/storage/buckets/{id}Mettez à jour les paramètres d’un bucket.
DELETE/v1/storage/buckets/{id}Supprimez un compartiment.
POST/v1/storage/{bucket}Téléchargez un fichier avec des données de formulaire en plusieurs parties.
GET/v1/storage/{bucket}/{key}Téléchargez un fichier, éventuellement transformé.
DELETE/v1/storage/{bucket}/{key}Supprimer un fichier.
GET/v1/storage/{bucket}/meta/{key}Lire les métadonnées d’un fichier.
POST/v1/storage/{bucket}/copyCopiez un fichier dans son bucket.
POST/v1/storage/{bucket}/moveDéplacez un fichier dans son bucket.
GET/v1/storage/{bucket}/signed-urlCréez une URL de téléchargement limitée dans le temps.
GET/v1/storage/{bucket}/upload-urlCréez une URL de téléchargement signée. Réservé au rôle de service.

Questions

Bon à savoir.

Un bucket public est-il vraiment public ?+
Oui. Toute personne disposant de l’URL peut télécharger ses fichiers, sans clé API. Ne mettez dans un compartiment public que ce que vous mettriez sur Internet ouvert.
Comment partager un fichier privé pendant un certain temps ?+
Créez une URL signée avec createSignedUrl() et une durée de vie en secondes. Le lien cesse de fonctionner à son expiration.
Quelle peut être l’ampleur d’une transformation d’image ?+
La largeur et la hauteur sont limitées à 2 500 px. Le paramètre de qualité s’applique uniquement au JPEG.
Puis-je copier un fichier vers un autre bucket ?+
Pas encore. Copiez et déplacez le travail dans un seul compartiment.
Les téléchargements avec reprise sont-ils pris en charge ?+
Non. Chaque téléchargement est une requête unique en plusieurs parties, prévoyez donc des fichiers qui tiennent dans une seule requête.
Puis-je désactiver les transformations d’image ?+
Oui. Les transformations sont activées par défaut et un projet peut les désactiver. Les requêtes avec une transformation sont alors refusées.

Prêt à stocker des fichiers ?

Donnez une maison à vos fichiers dès aujourd’hui.

Le stockage est inclus dans chaque projet. Aucune carte de crédit requise.