メインコンテンツまでスキップ
バージョン: 0.9.0 (最新)

📁 ファイルストレージブロック

ファイルストレージブロックは、NodeBlocksアプリケーション用の安全なファイル管理機能を提供します。これらのブロックは、セキュリティを強化するために署名付きURLを使用して、クラウドストレージプロバイダーを通じてファイルのアップロード、ダウンロード、削除操作を処理します。

🎯 概要​

ファイルストレージブロックは以下の目的で設計されています：

  • 安全なファイル操作用の署名付きURLの生成
  • コンテンツタイプ検証による複数のファイルタイプのサポート
  • 自動UUID生成によるアバターアップロードの処理
  • ストレージドライバーを通じたクラウドストレージ統合の提供
  • 事前署名付きURLによる安全なファイルアクセスの保証
  • ファイルライフサイクル管理のサポート（アップロード、ダウンロード、削除）

📦 ブロックタイプ​

🔍 スキーマ​

ファイルストレージ操作用のJSONスキーマ/OpenAPI定義：

  • getSignedImageUploadUrlSchema: 画像アップロード署名付きURL生成（クエリパラメータとレスポンスを含むOpenAPI操作）
  • getSignedFileUploadUrlSchema: セキュリティフィルタリング付きファイルアップロード署名付きURL生成（クエリパラメータとレスポンスを含むOpenAPI操作）

ファイルストレージスキーマを表示 →

🔧 ブロック​

ファイルストレージ操作用の純粋なビジネスロジック関数：

  • generateSignedUploadUrl: ファイルアップロード用の署名付きURLを生成
  • generateSignedDownloadUrl: ファイルダウンロード用の署名付きURLを生成
  • generateSignedDeleteUrl: ファイル削除用の署名付きURLを生成
  • deleteFile: ストレージドライバーを介してファイルを直接削除
  • generateSignedAvatarUploadUrl: UUIDを使用したアバターアップロード用の署名付きURLを生成
  • generateFileUploadUrl: 汎用ファイルアップロード用の自動UUIDオブジェクトID生成付き署名付きアップロードURLを生成
  • normalizeFile: APIレスポンス用の署名付きダウンロードURL生成付きファイルデータの正規化

ファイルストレージブロックを表示 →

🔗 関連ドキュメント​