NUEVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Ver el registro de cambios →

Almacenamiento

Almacenamiento de archivos, con el trabajo de imágenes hecho por usted.

Depósitos, cargas, enlaces firmados y transformaciones de imágenes sobre la marcha, desde el mismo SDK que sus datos.

4
formatos de salida de imagen
2,500 px
tamaño máximo de transformación
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'],
})

¿Qué está incluido?

Todo lo que necesita un archivo. De la carga a la miniatura.

Organización

Cubos con reglas

Establezca un límite de tamaño y los tipos de archivos permitidos en cada depósito.

Subir

Cargas simples

Envíe un archivo con una sola llamada, con sobrescritura cuando lo desees.

Descargar

Blob o secuencia

Descargue un archivo como Blob o léalo como una secuencia.

Compartir

URL firmadas

Comparte un archivo privado con un enlace que caduca después del tiempo que elijas.

cubos públicos

Público cuando usted lo diga

Los archivos en un depósito público se entregan a cualquier persona, sin una clave API. Mantenga archivos privados en un depósito privado.

Imágenes

La imagen se transforma sobre la marcha

Cambie el tamaño, recorte y convierta imágenes a JPEG, PNG, WebP o GIF con opciones de URL. Los resultados se almacenan en caché en el servidor.

Archivos

Copiar, mover y enumerar

Copie o mueva archivos dentro de un depósito, enumere por prefijo y lea metadatos.

Seguridad

Papelera antes de eliminar

Al eliminar un archivo, se envía a la papelera. La eliminación permanente necesita el rol de servicio.

Lado del servidor

Cargas firmadas desde su servidor

Cree URL de carga firmadas con la función de servicio para que los clientes puedan cargar sin tener que tener sus claves.

como funciona

De un archivo a un enlace.

  1. 1

    Crear un cubo

    Elija público o privado, un límite de tamaño y tipos permitidos.

  2. 2

    Subir

    Enviar el archivo; el servidor devuelve su clave.

  3. 3

    Compartir

    Utilice una URL pública o una URL firmada que caduque.

  4. 4

    transformar

    Agregue ancho, alto o formato a la URL para obtener una imagen derivada.

API REST

¿Prefieres HTTP simple? Está todo aquí.

El SDK es una fina capa sobre estas rutas. Envíe la clave API de su proyecto con cada solicitud.

MétodoPunto finalDescripción
GET/v1/storage/bucketsLista de cubos.
POST/v1/storage/bucketsCree un cubo.
PATCH/v1/storage/buckets/{id}Actualiza la configuración de un depósito.
DELETE/v1/storage/buckets/{id}Eliminar un depósito.
POST/v1/storage/{bucket}Cargue un archivo con datos de formulario de varias partes.
GET/v1/storage/{bucket}/{key}Descargue un archivo, opcionalmente transformado.
DELETE/v1/storage/{bucket}/{key}Eliminar un archivo.
GET/v1/storage/{bucket}/meta/{key}Leer los metadatos de un archivo.
POST/v1/storage/{bucket}/copyCopie un archivo dentro de su depósito.
POST/v1/storage/{bucket}/moveMueva un archivo dentro de su depósito.
GET/v1/storage/{bucket}/signed-urlCree una URL de descarga por tiempo limitado.
GET/v1/storage/{bucket}/upload-urlCree una URL de carga firmada. Reservado al rol de servicio.

Preguntas

Es bueno saberlo.

¿Es realmente público un depósito público?+
Sí. Cualquiera que tenga la URL puede descargar sus archivos, sin una clave API. Ponga en un recipiente público únicamente lo que pondría en Internet abierto.
¿Cómo comparto un archivo privado por un tiempo?+
Cree una URL firmada con createSignedUrl() y una vida útil en segundos. El enlace deja de funcionar cuando caduca.
¿Qué tamaño puede tener una transformación de imagen?+
El ancho y el alto tienen un límite de 2500 px. La configuración de calidad se aplica únicamente a JPEG.
¿Puedo copiar un archivo a otro depósito?+
Aún no. Copie y mueva el trabajo dentro de un solo depósito.
¿Se admiten las cargas reanudables?+
No. Cada carga es una solicitud única de varias partes, así que planifique archivos que quepan en una sola solicitud.
¿Puedo desactivar las transformaciones de imágenes?+
Sí. Las transformaciones están activadas de forma predeterminada y un proyecto puede desactivarlas. Luego se rechazan las solicitudes con una transformación.

¿Listo para almacenar archivos?

Dale un hogar a sus archivos hoy.

El almacenamiento está incluido en cada proyecto. No se requiere tarjeta de crédito.