新しい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'],
})

含まれるもの

ファイルに必要なものすべて。 アップロードからサムネイルまで。

組織

ルールのあるバケット

各バケットにサイズ制限と許可されるファイル タイプを設定します。

アップロード

簡単なアップロード

1 回の呼び出しでファイルを送信し、必要なときに上書きします。

ダウンロード

BLOB またはストリーム

ファイルを 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 のみに適用されます。
ファイルを別のバケットにコピーできますか?+
まだ。単一のバケット内で作業をコピーおよび移動します。
再開可能なアップロードはサポートされていますか?+
いいえ。各アップロードは 1 つのマルチパート リクエストであるため、1 つのリクエストに収まるファイルを計画してください。
画像変換をオフにできますか?+
はい。変換はデフォルトでオンになっており、プロジェクトによって無効にできます。変換を伴うリクエストは拒否されます。

ファイルを保存する準備はできましたか?

今すぐファイルを家に置きましょう。

ストレージはすべてのプロジェクトに含まれます。クレジットカードは必要ありません。