RustFS Bucket Creation

This chapter shares how to create buckets through RustFS UI, mc (MinIO Client), or API.

Creating Buckets

Prerequisites:

• An available RustFS instance. Refer to the Installation Guide for installation.

Creating Buckets on RustFS UI

1. Log into the RustFS UI console.
2. On the homepage, in the top left corner, select Create Bucket.
3. Enter the bucket name and click Create to complete bucket creation.

Creating Buckets Using mc

For mc installation and configuration, see the mc Usage Guide chapter.

Use the mc mb command to create buckets:

# create rustfs bucket
mc mb rustfs/bucket-creation-by-mc
Bucket created successfully `rustfs/bucket-creation-by-mc`.

# confirm bucket creation
mc ls rustfs/bucket-creation-by-mc

Creating Buckets Using API

Use the following API to create buckets:

PUT /{bucketName} HTTP/1.1

Request example:

curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api' \
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
--header 'X-Amz-Date: 20250801T023519Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=c2fb2ba5199a30ebcfa9976d0f35000ba274da3701327957e84ea0f3920288f2'

You can confirm on the RustFS UI that the bucket-creation-by-api bucket has been successfully created.