📁 ファイルストレージブロック
ファイルストレージブロックは、NodeBlocks アプリケーションのための安全なファイル管理機能を提供します。これらのブロックは、セキュリティ強化のための署名付き URL を使用して、クラウドストレージプロバイダーを通じたファイルのアップロード、ダウンロード、削除操作を処理します。
🎯 概要
ファイルストレージブロックは次のことを目的として設計されています:
- 安全なファイル操作のために署名付き URL を生成する
- コンテンツタイプ検証で複数のファイルタイプをサポートする
- 自動 UUID 生成でアバターアップロードを処理する
- ストレージドライバーを通じてクラウドストレージ統合を提供する
- 事前署名付き URL で安全なファイルアクセスを確保する
- ファイルライフサイクル管理（アップロード、ダウンロード、削除）をサポートする
📋 ファイルストレージブロックタイプ
コアファイルストレージブロック
一般的なファイル管理のための基本的なファイルストレージ操作。
アバターファイルストレージブロック
事前定義された設定でアバターファイルアップロード用の特殊化されたブロック。
署名付き URL 生成ブロック
ファイル操作のための安全で時間制限付きアクセス URL を作成するブロック。
🔧 利用可能なファイルストレージブロック
コア操作
generateSignedUploadUrl- ファイルアップロード用の署名付き URL を生成generateSignedDownloadUrl- ファイルダウンロード用の署名付き URL を生成generateSignedDeleteUrl- ファイル削除用の署名付き URL を生成deleteFile- ストレージドライバー経由でファイルを直接削除
アバター操作
generateSignedAvatarUploadUrl- UUID 付きアバターアップロード用の署名付き URL を生成
🚀 クイックスタート
import {
generateSignedUploadUrl,
generateSignedDownloadUrl,
generateSignedAvatarUploadUrl
} from '@nodeblocks/backend-sdk/blocks/file-storage';
// アップロード URL を生成
const uploadResult = await generateSignedUploadUrl(
logger,
fileStorageDriver,
'image/jpeg',
1024000,
'uploads/document.pdf'
);
// ダウンロード URL を生成
const downloadResult = await generateSignedDownloadUrl(
logger,
fileStorageDriver,
'uploads/document.pdf'
);
// アバターアップロード URL を生成
const avatarResult = await generateSignedAvatarUploadUrl(
logger,
fileStorageDriver,
'image/png',
512000
);
🔍 スキーマ
ファイルストレージ操作のための JSON Schema/OpenAPI 定義:
getSignedImageUploadUrlSchema: 画像アップロード署名付き URL 生成（クエリパラメータとレスポンス付き OpenAPI 操作）
🔗 関連ドキュメント
- ファイルストレージブロック - 詳細なブロックドキュメント
- ファイルストレージスキーマ - スキーマドキュメント
- ファイルストレージドライバー - ドライバー設定とセットアップ