NUOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Vedi il registro delle modifiche →

Archiviazione

Archiviazione di file, con il lavoro sulle immagini svolto per te.

Bucket, caricamenti, link firmati e trasformazioni di immagini al volo, dallo stesso SDK dei tuoi dati.

4
formati di output delle immagini
2,500 px
dimensione massima della trasformazione
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'],
})

Cosa è incluso

Tutto ciò di cui ha bisogno un file. Dal caricamento alla miniatura.

Organizzazione

Secchi con regole

Imposta un limite di dimensione e i tipi di file consentiti su ciascun bucket.

Carica

Caricamenti semplici

Invia un file con una sola chiamata, sovrascrivilo quando vuoi.

Scarica

BLOB o flusso

Scarica un file come BLOB o leggilo come flusso.

Condivisione

URL firmati

Condividi un file privato con un collegamento che scade dopo il tempo da te scelto.

Secchi pubblici

Pubblico quando lo dici tu

I file in un bucket pubblico vengono serviti a chiunque, senza una chiave API. Mantieni i file privati ​​in un bucket privato.

Immagini

L'immagine si trasforma al volo

Ridimensiona, ritaglia e converti le immagini in JPEG, PNG, WebP o GIF con le opzioni URL. I risultati vengono memorizzati nella cache del server.

File

Copia, sposta ed elenca

Copia o sposta i file all'interno di un bucket, elenca per prefisso e leggi i metadati.

Sicurezza

Cestino prima dell'eliminazione

La rimozione di un file lo sposta nel cestino. L'eliminazione permanente richiede il ruolo del servizio.

Lato server

Caricamenti firmati dal tuo server

Crea URL di caricamento firmati con il ruolo del servizio in modo che i clienti possano caricare senza conservare le tue chiavi.

Come funziona

Da un file a un collegamento.

  1. 1

    Crea un secchio

    Scegli pubblico o privato, un limite di dimensione e i tipi consentiti.

  2. 2

    Carica

    Invia il file; il server restituisce la sua chiave.

  3. 3

    Condividi

    Utilizza un URL pubblico o un URL firmato con scadenza.

  4. 4

    Trasformare

    Aggiungi larghezza, altezza o formato all'URL per ottenere un'immagine derivata.

API REST

Preferisci il semplice HTTP? È tutto qui.

L'SDK è uno strato sottile su questi percorsi. Invia la chiave API del tuo progetto con ogni richiesta.

MetodoPunto finaleDescrizione
GET/v1/storage/bucketsElenca i bucket.
POST/v1/storage/bucketsCrea un secchio.
PATCH/v1/storage/buckets/{id}Aggiorna le impostazioni di un bucket.
DELETE/v1/storage/buckets/{id}Elimina un bucket.
POST/v1/storage/{bucket}Carica un file con i dati del modulo multiparte.
GET/v1/storage/{bucket}/{key}Scarica un file, facoltativamente trasformato.
DELETE/v1/storage/{bucket}/{key}Elimina un file.
GET/v1/storage/{bucket}/meta/{key}Leggere i metadati di un file.
POST/v1/storage/{bucket}/copyCopia un file all'interno del suo bucket.
POST/v1/storage/{bucket}/moveSposta un file all'interno del suo bucket.
GET/v1/storage/{bucket}/signed-urlCrea un URL di download limitato nel tempo.
GET/v1/storage/{bucket}/upload-urlCrea un URL di caricamento firmato. Riservato al ruolo di servizio.

Domande

Buono a sapersi.

Un secchio pubblico è davvero pubblico?+
Sì. Chiunque abbia l'URL può scaricarne i file, senza una chiave API. Metti in un secchio pubblico solo ciò che metteresti su Internet aperta.
Come faccio a condividere un file privato per un po'?+
Crea un URL firmato con createSignedUrl() e una durata in secondi. Il collegamento smette di funzionare quando scade.
Quanto può essere grande la trasformazione di un'immagine?+
La larghezza e l'altezza sono limitate a 2.500 px. L'impostazione della qualità si applica solo a JPEG.
Posso copiare un file in un altro bucket?+
Non ancora. Copia e sposta il lavoro all'interno di un unico bucket.
Sono supportati i caricamenti ripristinabili?+
No. Ogni caricamento è una singola richiesta in più parti, quindi pianifica i file che rientrano in un'unica richiesta.
Posso disattivare le trasformazioni delle immagini?+
Sì. Le trasformazioni sono attive per impostazione predefinita e un progetto può disabilitarle. Le richieste con una trasformazione vengono quindi rifiutate.

Pronto per archiviare i file?

Dai una casa ai tuoi file oggi stesso.

Lo spazio di archiviazione è incluso in ogni progetto. Nessuna carta di credito richiesta.