NOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Veja o changelog →

Armazenamento

Armazenamento de arquivos, com o trabalho de imagem feito para você.

Buckets, uploads, links assinados e transformações de imagens dinâmicas, a partir do mesmo SDK dos seus dados.

4
formatos de saída de imagem
2,500 px
tamanho máximo de transformação
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'],
})

O que está incluído

Tudo que um arquivo precisa. Do upload à miniatura.

Organização

Baldes com regras

Defina um limite de tamanho e os tipos de arquivo permitidos em cada bucket.

Carregar

Carregamentos simples

Envie um arquivo com uma única chamada, com substituição quando desejar.

Baixar

Blob ou fluxo

Baixe um arquivo como um Blob ou leia-o como um stream.

Compartilhando

URLs assinados

Compartilhe um arquivo privado com um link que expira após o horário que você escolher.

Buckets públicos

Público quando você diz isso

Os arquivos em um bucket público são fornecidos a qualquer pessoa, sem uma chave de API. Mantenha os arquivos privados em um bucket privado.

Imagens

Transformações de imagem instantâneas

Redimensione, corte e converta imagens para JPEG, PNG, WebP ou GIF com opções de URL. Os resultados são armazenados em cache no servidor.

Arquivos

Copiar, mover e listar

Copie ou mova arquivos dentro de um bucket, liste por prefixo e leia metadados.

Segurança

Lixeira antes de excluir

A remoção de um arquivo o move para a lixeira. A exclusão permanente precisa da função de serviço.

Lado do servidor

Uploads assinados do seu servidor

Crie URLs de upload assinados com a função de serviço para que os clientes possam fazer upload sem manter suas chaves.

Como funciona

De um arquivo para um link.

  1. 1

    Crie um balde

    Escolha público ou privado, um limite de tamanho e tipos permitidos.

  2. 2

    Carregar

    Envie o arquivo; o servidor retorna sua chave.

  3. 3

    Compartilhar

    Use um URL público ou um URL assinado que expire.

  4. 4

    Transformar

    Adicione largura, altura ou formato ao URL para obter uma imagem derivada.

API REST

Prefere HTTP simples? Está tudo aqui.

O SDK é uma camada fina sobre essas rotas. Envie a chave API do seu projeto com cada solicitação.

MétodoPonto finalDescrição
GET/v1/storage/bucketsListar intervalos.
POST/v1/storage/bucketsCrie um balde.
PATCH/v1/storage/buckets/{id}Atualize as configurações de um bucket.
DELETE/v1/storage/buckets/{id}Exclua um bucket.
POST/v1/storage/{bucket}Carregue um arquivo com dados de formulário multiparte.
GET/v1/storage/{bucket}/{key}Baixe um arquivo, opcionalmente transformado.
DELETE/v1/storage/{bucket}/{key}Exclua um arquivo.
GET/v1/storage/{bucket}/meta/{key}Leia os metadados de um arquivo.
POST/v1/storage/{bucket}/copyCopie um arquivo dentro de seu bucket.
POST/v1/storage/{bucket}/moveMova um arquivo dentro de seu bucket.
GET/v1/storage/{bucket}/signed-urlCrie um URL de download por tempo limitado.
GET/v1/storage/{bucket}/upload-urlCrie um URL de upload assinado. Reservado para a função de serviço.

Perguntas

É bom saber.

Um bucket público é realmente público?+
Sim. Qualquer pessoa com o URL pode baixar seus arquivos, sem uma chave de API. Coloque em um balde público apenas o que você colocaria na Internet aberta.
Como faço para compartilhar um arquivo privado por um tempo?+
Crie um URL assinado com createSignedUrl() e um tempo de vida em segundos. O link para de funcionar quando expira.
Quão grande pode ser uma transformação de imagem?+
A largura e a altura são limitadas a 2.500 px. A configuração de qualidade aplica-se apenas a JPEG.
Posso copiar um arquivo para outro bucket?+
Ainda não. Copie e mova o trabalho dentro de um único bucket.
Os uploads recuperáveis são suportados?+
Não. Cada upload é uma única solicitação multiparte, então planeje arquivos que caibam em uma solicitação.
Posso desligar as transformações de imagem?+
Sim. As transformações estão ativadas por padrão e um projeto pode desativá-las. As solicitações com uma transformação são então recusadas.

Pronto para armazenar arquivos?

Dê um lar aos seus arquivos hoje.

O armazenamento está incluído em cada projeto. Não é necessário cartão de crédito.