使用制限
一、S3 API 制限
以下の標準はS3プロトコル標準に厳格に従って規範化されています。
| 項目 | 仕様 |
|---|---|
| 最大オブジェクトサイズ | 5 TiB |
| 最小オブジェクトサイズ | 0 B |
| 単一PUT操作の最大オブジェクトサイズ | 非マルチパートアップロード：500 GiB；マルチパートアップロード：5 TiB |
| アップロードあたりの最大パート数 | 10,000 |
| パートサイズ範囲 | 5 MiB から 5 GiB；最後のパートは 0 B から 5 GiB |
| パートリストリクエストで返される最大パート数 | 10,000 |
| オブジェクトリストリクエストで返される最大オブジェクト数 | 1,000 |
| マルチパートアップロードリストリクエストで返される最大マルチパートアップロード数 | 1,000 |
| バケット名の最大長 | 63文字 |
| オブジェクト名の最大長 | 1024文字 |
/で区切られたオブジェクト名セグメントの最大長 | 255文字 |
| 単一オブジェクトの最大バージョン数 | 10,000（設定可能） |
二、イレイジャーコーディング制限
ECパラメータは、リード・ソロモン行列ベースのECアルゴリズムに基づいて設定してください。実際のECパラメータ設定に従ってください。
| 項目 | 仕様 |
|---|---|
| クラスターあたりの最大サーバー数 | 無制限 |
| 最小サーバー数 | 1 |
| サーバー数が1の場合の各サーバーの最小ドライブ数 | 1（単一ノード単一ドライブ展開に適用、追加の信頼性や可用性は提供されません） |
| サーバー数が2以上の場合の各サーバーの最小ドライブ数 | 1 |
| 各サーバーの最大ドライブ数 | 無制限 |
| 読み取りクォーラム数 | N/2 |
| 書き込みクォーラム数 | (N/2) + 1 |
三、オブジェクト命名制限
ファイルシステムとオペレーティングシステム制限
RustFS のオブジェクト名は主に基盤となるオペレーティングシステムとファイルシステムの制限を受けます。例えば、Windows やその他の一部のオペレーティングシステムは、^、*、|、\、/、&、"、; などの特定の特殊文字の使用を制限します。
お使いのオペレーティングシステムとファイルシステムの具体的な状況に応じて、関連ドキュメントを参照して完全な制限リストを取得してください。
RustFS では、より良いパフォーマンスと互換性を得るために、本番環境で XFS ファイルシステムベースの Linux オペレーティングシステムの使用を推奨します。
命名競合処理
RustFS では、アプリケーションはすべてのオブジェクトに一意で競合しないキーを割り当てる必要があります。これには、親オブジェクトや同階層オブジェクト名と競合する可能性のある名前のオブジェクトの作成を避けることが含まれます。RustFS は競合が発生した場所で LIST 操作を実行すると空のセットを返します。
例えば、以下の操作は名前空間の競合を引き起こします：
bash
PUT data/hello/2025/first/a.csv
PUT data/hello/2025/first # 既存のオブジェクトプレフィックスと競合
PUT data/hello/2025/first/
PUT data/hello/2025/first/vendors.csv # 既存のオブジェクトと競合これらのオブジェクトに対して GET や HEAD 操作を実行することは可能ですが、名前の競合により hello/2025/first/ パスで LIST 操作を実行すると空の結果セットが返されます。