|
| 1 | +--- |
| 2 | +title: "RustFS オブジェクト管理" |
| 3 | +description: "オブジェクトの作成と削除" |
| 4 | +--- |
| 5 | + |
| 6 | +# RustFS オブジェクト |
| 7 | + |
| 8 | +オブジェクト(Object)は RustFS における最小単位で、データ・メタデータ・一意キー(Object Key)を含みます。本章ではファイルのアップロード/削除を例に管理方法を説明します。 |
| 9 | + |
| 10 | +> 関連概念は「[コア概念](../../concepts/glossary.md)」を参照してください。 |
| 11 | +
|
| 12 | +## オブジェクトの作成 |
| 13 | + |
| 14 | +前提条件: |
| 15 | + |
| 16 | +- 利用可能な RustFS インスタンス(../../installation/index.md を参照) |
| 17 | + |
| 18 | +[バケットを作成](bucket-create-and-delete.md)し、当該バケットにファイルをアップロードするとオブジェクトが作成されます。RustFS UI、`mc`、API のいずれでも可能です。 |
| 19 | + |
| 20 | +### RustFS UI でアップロード |
| 21 | + |
| 22 | +1. RustFS UI コンソールにログイン |
| 23 | +1. 対象バケットを選択 |
| 24 | +1. 右上の「新規ディレクトリ」「新規ファイル」「ファイル/フォルダをアップロード」を選択 |
| 25 | +1. ローカルからアップロードする場合は「ファイル/フォルダをアップロード」→対象を選択→「アップロード開始」 |
| 26 | + |
| 27 | + |
| 28 | + |
| 29 | +アップロード後、当該オブジェクトをクリックして詳細を確認できます。 |
| 30 | + |
| 31 | + |
| 32 | + |
| 33 | +### `mc` でアップロード |
| 34 | + |
| 35 | +> `mc` のインストール/設定は「`mc` ガイド」(../mc.md)を参照 |
| 36 | +
|
| 37 | +``` |
| 38 | +# upload file |
| 39 | +mc cp 1.txt rustfs/bucket-creation-by-mc |
| 40 | +/tmp/1.txt: 13 B / 13 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 61 B/s 0s% |
| 41 | +
|
| 42 | +# confirm file uploaded |
| 43 | +mc ls rustfs/bucket-creation-by-mc |
| 44 | +[2025-08-01 10:01:08 CST] 13B 1.txt |
| 45 | +``` |
| 46 | + |
| 47 | +### API でアップロード |
| 48 | + |
| 49 | +``` |
| 50 | +PUT /{bucketName}/{objectName} HTTP/1.1 |
| 51 | +``` |
| 52 | + |
| 53 | +例: |
| 54 | + |
| 55 | +``` |
| 56 | +curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \ |
| 57 | +--header 'Content-Type: text/plain' \ |
| 58 | +--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \ |
| 59 | +--header 'X-Amz-Date: 20250801T024840Z' \ |
| 60 | +--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=b7d8dc29ee34dfdf1f3e9e8e069892a8936f478586e7a2c90cf34f5b86d3a2dc' \ |
| 61 | +--data-binary '@/path/to/password.txt' |
| 62 | +``` |
| 63 | + |
| 64 | +## オブジェクトの削除 |
| 65 | + |
| 66 | +UI、`mc`、API のいずれでも削除できます。上記で作成したファイルを削除すれば完了です。 |
| 67 | + |
| 68 | +## RustFS UI で削除 |
| 69 | + |
| 70 | +1. RustFS UI コンソールにログイン |
| 71 | +1. 対象バケットを選択 |
| 72 | +1. 対象ファイルを選択 |
| 73 | +1. 右上の「選択項目を削除」→ダイアログで「確認」 |
| 74 | + |
| 75 | + |
| 76 | + |
| 77 | +### `mc` で削除 |
| 78 | + |
| 79 | +``` |
| 80 | +# delete file |
| 81 | +mc rm rustfs/bucket-creation-by-mc/1.txt |
| 82 | +Removed `rustfs/bucket-creation-by-mc/1.txt`. |
| 83 | +
|
| 84 | +# confirm deletion |
| 85 | +mc ls rustfs/bucket-creation-by-mc/1.txt |
| 86 | +``` |
| 87 | + |
| 88 | +### API で削除 |
| 89 | + |
| 90 | +``` |
| 91 | +DELETE /{bucketName}/{objectName} HTTP/1.1 |
| 92 | +``` |
| 93 | + |
| 94 | +例: |
| 95 | + |
| 96 | +``` |
| 97 | +curl --location --request DELETE 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \ |
| 98 | +--header 'Content-Type: text/plain' \ |
| 99 | +--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \ |
| 100 | +--header 'X-Amz-Date: 20250801T030822Z' \ |
| 101 | +--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=1ee63bb0b699598602b2fdbd013e355a57bcb9991307a8ad41f6512e8afebf3a' \ |
| 102 | +--data-binary '@/Users/jhma/Desktop/password.txt' |
| 103 | +``` |
0 commit comments