bkend-storage

bkend.ai ストレージガイド

アップロード方法

方法	用途	手順
単一	通常のファイル	署名付き URL -> PUT アップロード -> メタデータを登録
複数	複数のファイル	単一アップロードを繰り返す
マルチパート	大容量ファイル	初期化 -> パート URL -> 完了

署名付き URL

• 有効期間：15 分
• ファイルのバイナリを PUT メソッドで送信
• Content-Type ヘッダーが必要

ファイルの公開範囲（4 段階）

レベル	アクセス	URL の種類
public	誰でも	CDN URL（有効期限なし）
private	所有者のみ	署名付き URL（1 時間）
protected	認証済みユーザー	署名付き URL（1 時間）
shared	指定された対象	署名付き URL（1 時間）

サイズ制限

カテゴリー	最大サイズ
画像	10 MB
動画	100 MB
ドキュメント	20 MB

ストレージカテゴリー

画像、ドキュメント、メディア、添付ファイル

MCP ストレージのワークフロー

bkend MCP には専用のストレージツールはありません。次のワークフローを使用します。

1. ドキュメントを検索：クエリ「file upload presigned url」で search_docs を実行
2. 例を取得：クエリ「file upload code examples」で search_docs を実行
3. コードを生成：AI がファイル操作用の REST API コードを生成

検索可能なストレージドキュメント

ドキュメント ID	内容
7_code_examples_data	CRUD + ファイルアップロードのコード例

REST ストレージ API

メソッド	エンドポイント	説明
POST	/v1/files/presigned-url	署名付き URL を生成
POST	/v1/files	メタデータを登録（アップロードを完了）
GET	/v1/files	ファイル一覧
GET	/v1/files/:fileId	ファイルの詳細
PATCH	/v1/files/:fileId	メタデータを更新
DELETE	/v1/files/:fileId	ファイルを削除
POST	/v1/files/:fileId/download-url	ダウンロード URL を生成

マルチパートアップロード（大容量ファイル）

メソッド	エンドポイント	説明
POST	/v1/files/multipart/init	マルチパートアップロードを初期化
POST	/v1/files/multipart/presigned-url	パートアップロード URL を取得
POST	/v1/files/multipart/complete	マルチパートアップロードを完了
POST	/v1/files/multipart/abort	マルチパートアップロードを中止

アップロードフロー（単一ファイル）

1. POST /v1/files/presigned-url -> { url, fileId }
2. PUT {url} with file binary + Content-Type header
3. POST /v1/files with { fileId, filename, contentType, size, visibility }

マルチパートアップロードフロー（大容量ファイル）

1. POST /v1/files/multipart/init -> { uploadId }
2. POST /v1/files/multipart/presigned-url -> [{ partNumber, url }]
3. PUT each part URL with file chunk
4. POST /v1/files/multipart/complete -> { file }

公式ドキュメント（最新情報）

最新のストレージドキュメントを参照するには、WebFetch を使用します。

• ストレージの概要：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/storage/01-overview.md
• MCP ストレージガイド：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/07-storage-tools.md
• 目次全文：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md