对象创建

对象是 RustFS 中基本的存储单元，包含数据、元数据和一个唯一的键。本指南涵盖对象创建（上传）。

有关对象相关的概念，请参阅 核心概念。

创建对象

先决条件

• 一个正在运行的 RustFS 实例（请参阅 安装指南）。

创建一个存储桶，然后将文件上传到其中。

使用 RustFS UI

1. 登录 RustFS 控制台。
2. 选择目标存储桶。
3. 在存储桶页面，右上角选择“新建目录”、“新建文件”或“上传文件/文件夹”。
4. 要从本地计算机上传，请点击“上传文件/文件夹”，选择文件，然后点击“开始上传”。

点击对象即可查看其详细信息。

使用 mc

有关安装和配置，请参阅 mc 使用指南。

上传文件

# upload file
mc cp 1.txt rustfs/bucket-creation-by-mc
/tmp/1.txt:            13 B / 13 B  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓  61 B/s 0s%

# confirm file uploaded
mc ls rustfs/bucket-creation-by-mc
[2025-08-01 10:01:08 CST]    13B 1.txt

在 RustFS 控制台中验证上传结果。

使用 API

通过 API 上传文件

PUT /{bucketName}/{objectName} HTTP/1.1

请求示例

curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \
--header 'Content-Type: text/plain' \
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
--header 'X-Amz-Date: 20250801T024840Z' \
--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' \
--data-binary '@/path/to/password.txt'

在 RustFS 控制台中验证上传结果。

删除对象

请参阅 对象删除。

使用以下 API 进行文件删除

DELETE /{bucketName}/{objectName} HTTP/1.1

请求示例

curl --location --request DELETE 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \
--header 'Content-Type: text/plain' \
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
--header 'X-Amz-Date: 20250801T030822Z' \
--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' \
--data-binary '@/Users/jhma/Desktop/password.txt'

您可以在 RustFS UI 中确认文件已被删除。