Metaplex

ツールボックス

ストレージへのアップロード

Last updated April 20, 2026

概要

mplx toolbox storage uploadコマンドは、単一のファイルまたはディレクトリ全体を、設定されたストレージプロバイダにアップロードします。

  • デフォルトでは1つのファイルをアップロードし、--directoryを指定するとディレクトリ配下のすべてのファイルをアップロードします。
  • ディレクトリのアップロードでは、各ファイルとそのURIをマッピングしたuploadCache.jsonが生成されます。
  • 残高が不足している場合、ストレージアカウントに自動的に入金します。
  • アップロードされたコンテンツのURIとMIMEタイプを返します。

クイックリファレンス

以下の表は、コマンドの入力、フラグ、および副作用をまとめたものです。

項目値
コマンドmplx toolbox storage upload <path> [--directory]
必須引数path — ファイルパス、または--directory付きでディレクトリパス
オプションフラグ--directory
ディレクトリ出力現在のディレクトリにuploadCache.jsonを書き込みます
プロバイダアクティブなストレージプロバイダ（例: Irys）

基本的な使用法

ファイルパスを渡して単一のファイルをアップロードするか、--directoryを追加してディレクトリ内のすべてのファイルをアップロードします。

# 単一のファイルをアップロード

mplx toolbox storage upload <path>



# ディレクトリ内のすべてのファイルをアップロード

mplx toolbox storage upload <directory> --directory

引数

唯一の位置引数は、アップロードされるパスです。

  • path (必須): ファイルへのパス、または--directoryと組み合わせる場合はディレクトリへのパス。

フラグ

オプションフラグはディレクトリモードに切り替えます。

  • --directory: 指定されたディレクトリ内のすべてのファイルをアップロードします。

例

これらの例は、単一ファイルとディレクトリのアップロードを示しています。

mplx toolbox storage upload ./metadata.json

mplx toolbox storage upload ./assets --directory

出力

単一ファイルのアップロードでは、結果のURIが出力されます。ディレクトリのアップロードでは、ファイル数とキャッシュファイルのパスが報告されます。

単一ファイル:

--------------------------------

    Uploaded <path>

    URI: <uri>

---------------------------------

ディレクトリ:

--------------------------------

    Successfully uploaded <N> files



    Upload cache saved to uploadCache.json

---------------------------------

注意事項

  • ストレージはアクティブなストレージプロバイダを通じて入金および請求されます。ストレージ残高が不足している場合、コマンドはアップロード前に自動的に入金します。
  • ストレージ残高を確認するにはtoolbox storage balanceを使用してください。
  • ストレージアカウントに入金するにはtoolbox storage fundを使用してください。
Next
残高