新Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2查看变更日志 →

存储

文件存储,为您完成图像工作。

存储桶、上传、签名链接和动态图像转换,来自与您的数据相同的 SDK。

4
图像输出格式
2,500 px
最大变换尺寸
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'],
})

包含什么

文件所需的一切。 从上传到缩略图。

组织机构

有规则的桶

设置每个存储桶的大小限制和允许的文件类型。

上传

简单上传

只需一次调用即可发送文件,并在需要时进行覆盖。

下载

斑点或流

以 Blob 形式下载文件,或以流形式读取文件。

分享

签名 URL

共享带有链接的私人文件,该链接在您选择的时间后就会过期。

公共水桶

当您这么说时公开

公共存储桶中的文件可供任何人使用,无需 API 密钥。将私有文件保存在私有存储桶中。

图片

即时图像变换

使用 URL 选项调整图像大小、裁剪图像并将其转换为 JPEG、PNG、WebP 或 GIF。结果缓存在服务器上。

文件

复制、移动和列表

复制或移动存储桶内的文件,按前缀列出并读取元数据。

安全

删除前先放入垃圾箱

删除文件会将其移至垃圾箱。永久删除需要服务角色。

服务器端

从您的服务器签名的上传

使用服务角色创建签名的上传 URL,以便客户端无需持有您的密钥即可上传。

它是如何运作的

从文件到链接。

  1. 1

    创建一个桶

    选择公共或私人、大小限制和允许的类型。

  2. 2

    上传

    发送文件;服务器返回其密钥。

  3. 3

    分享

    使用公共 URL 或过期的签名 URL。

  4. 4

    变换

    将宽度、高度或格式添加到 URL 以获取派生图像。

REST API

更喜欢纯 HTTP? 一切都在这里。

SDK 是这些路由之上的一个薄层。在每个请求中发送您项目的 API 密钥。

方法端点描述
GET/v1/storage/buckets列出存储桶。
POST/v1/storage/buckets创建一个存储桶。
PATCH/v1/storage/buckets/{id}更新存储桶的设置。
DELETE/v1/storage/buckets/{id}删除一个桶。
POST/v1/storage/{bucket}上传包含多部分表单数据的文件。
GET/v1/storage/{bucket}/{key}下载一个文件,可以选择转换。
DELETE/v1/storage/{bucket}/{key}删除一个文件。
GET/v1/storage/{bucket}/meta/{key}读取文件的元数据。
POST/v1/storage/{bucket}/copy将文件复制到其存储桶内。
POST/v1/storage/{bucket}/move将文件移动到其存储桶内。
GET/v1/storage/{bucket}/signed-url创建一个限时下载 URL。
GET/v1/storage/{bucket}/upload-url创建签名的上传 URL。保留给服务角色。

问题

很高兴知道。

公共存储桶真的是公共的吗?+
是的。任何知道该 URL 的人都可以下载其文件,无需 API 密钥。仅将您将放在开放互联网上的内容放入公共存储桶中。
如何暂时共享私人文件?+
使用 createSignedUrl() 创建签名 URL,生命周期以秒为单位。链接过期后将停止工作。
图像变换可以有多大?+
宽度和高度上限为 2,500 像素。质量设置仅适用于 JPEG。
我可以将文件复制到另一个存储桶吗?+
还没有。在单个存储桶内复制和移动工作。
支持断点续传吗?+
不会。每次上传都是一个单独的多部分请求,因此请规划适合一个请求的文件。
我可以关闭图像转换吗?+
是的。变换默认处于启用状态,项目可以禁用它们。然后,带有转换的请求将被拒绝。

准备好存储文件了吗?

今天就给您的文件一个家。

每个项目都包含存储。无需信用卡。