NIEUWPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Zie de changelog →

Opslag

Bestandsopslag, waarbij het beeldwerk voor u wordt gedaan.

Buckets, uploads, ondertekende links en on-the-fly beeldtransformaties, vanuit dezelfde SDK als uw gegevens.

4
uitvoerformaten voor afbeeldingen
2,500 px
maximale transformatiegrootte
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'],
})

Wat is inbegrepen

Alles wat een bestand nodig heeft. Van upload tot thumbnail.

Organisatie

Emmers met regels

Stel een maximale grootte in en de toegestane bestandstypen voor elke bucket.

Uploaden

Eenvoudige uploads

Verzend een bestand met één enkele oproep, met overschrijving wanneer u dat wilt.

Downloaden

Blob of stroom

Download een bestand als een blob of lees het als een stream.

Delen

Ondertekende URL's

Deel een privébestand met een link die vervalt na het door u gekozen tijdstip.

Openbare emmers

Openbaar als u het zegt

Bestanden in een openbare bucket kunnen aan iedereen worden aangeboden, zonder API-sleutel. Bewaar privébestanden in een privébucket.

Afbeeldingen

On-the-fly beeldtransformaties

Formaat wijzigen, bijsnijden en afbeeldingen converteren naar JPEG, PNG, WebP of GIF met URL-opties. De resultaten worden op de server in de cache opgeslagen.

Bestanden

Kopiëren, verplaatsen en opsommen

Kopieer of verplaats bestanden binnen een bucket, sorteer ze op voorvoegsel en lees metagegevens.

Veiligheid

Prullenbak voordat u het verwijdert

Als u een bestand verwijdert, wordt het naar de prullenbak verplaatst. Voor permanente verwijdering is de servicerol vereist.

Serverzijde

Ondertekende uploads vanaf uw server

Maak ondertekende upload-URL's met de servicerol, zodat klanten kunnen uploaden zonder uw sleutels vast te houden.

Hoe het werkt

Van een bestand naar een link.

  1. 1

    Maak een emmer

    Kies openbaar of privé, een maximale grootte en toegestane typen.

  2. 2

    Uploaden

    Verstuur het bestand; de server retourneert zijn sleutel.

  3. 3

    Deel

    Gebruik een openbare URL of een ondertekende URL die verloopt.

  4. 4

    Transformeren

    Voeg breedte, hoogte of formaat toe aan de URL om een afgeleide afbeelding te krijgen.

REST-API

Liever gewone HTTP? Het is allemaal hier.

De SDK is een dunne laag over deze routes. Stuur bij elk verzoek de API-sleutel van uw project mee.

MethodeEindpuntBeschrijving
GET/v1/storage/bucketsMaak een lijst van emmers.
POST/v1/storage/bucketsMaak een emmer.
PATCH/v1/storage/buckets/{id}Update de instellingen van een bucket.
DELETE/v1/storage/buckets/{id}Een emmer verwijderen.
POST/v1/storage/{bucket}Upload een bestand met meerdelige formuliergegevens.
GET/v1/storage/{bucket}/{key}Download een bestand, eventueel getransformeerd.
DELETE/v1/storage/{bucket}/{key}Verwijder een bestand.
GET/v1/storage/{bucket}/meta/{key}Lees de metadata van een bestand.
POST/v1/storage/{bucket}/copyKopieer een bestand binnen zijn bucket.
POST/v1/storage/{bucket}/moveVerplaats een bestand binnen zijn bucket.
GET/v1/storage/{bucket}/signed-urlMaak een in de tijd beperkte download-URL.
GET/v1/storage/{bucket}/upload-urlMaak een ondertekende upload-URL. Gereserveerd voor de servicerol.

Vragen

Goed om te weten.

Is een openbare bucket echt openbaar?+
Ja. Iedereen met de URL kan de bestanden downloaden, zonder API-sleutel. Stop alleen in een publieke bucket wat u ook op het open internet zou zetten.
Hoe deel ik een privébestand een tijdje?+
Maak een ondertekende URL met createSignedUrl() en een levensduur in seconden. De link werkt niet meer wanneer deze verloopt.
Hoe groot kan een beeldtransformatie zijn?+
Breedte en hoogte zijn beperkt tot 2500 px. De kwaliteitsinstelling geldt alleen voor JPEG.
Kan ik een bestand naar een andere bucket kopiëren?+
Nog niet. Kopieer en verplaats werk binnen één bucket.
Worden hervatbare uploads ondersteund?+
Nee. Elke upload is een enkelvoudig, uit meerdere delen bestaand verzoek, dus plan bestanden die in één verzoek passen.
Kan ik beeldtransformaties uitschakelen?+
Ja. Transformaties zijn standaard ingeschakeld en een project kan deze uitschakelen. Verzoeken met een transformatie worden vervolgens geweigerd.

Klaar om bestanden op te slaan?

Geef uw bestanden vandaag nog een thuis.

Bij elk project is opslag inbegrepen. Geen creditcard vereist.