Bucket Operations

S4 supports standard S3 bucket operations.

CreateBucket

Creates a new bucket.

# AWS CLI
aws --endpoint-url http://localhost:9000 s3 mb s3://mybucket

# curl
curl -X PUT http://localhost:9000/mybucket

Response: 200 OK

ListBuckets

Lists all buckets.

# AWS CLI
aws --endpoint-url http://localhost:9000 s3 ls

# curl
curl http://localhost:9000/

Response: XML listing of all buckets with names and creation dates.

DeleteBucket

Deletes an empty bucket.

# AWS CLI
aws --endpoint-url http://localhost:9000 s3 rb s3://mybucket

# curl
curl -X DELETE http://localhost:9000/mybucket

Response: 204 No Content

The bucket must be empty before it can be deleted.

HeadBucket

Checks if a bucket exists.

aws --endpoint-url http://localhost:9000 s3api head-bucket --bucket mybucket

Response: 200 OK if the bucket exists, 404 Not Found otherwise.

ListObjects (v2)

Lists objects in a bucket with optional prefix filtering and pagination.

# List all objects
aws --endpoint-url http://localhost:9000 s3 ls s3://mybucket

# List with prefix
aws --endpoint-url http://localhost:9000 s3 ls s3://mybucket/logs/

# curl with parameters
curl "http://localhost:9000/mybucket?list-type=2&prefix=logs/&max-keys=100"

Query parameters:

Response: XML listing of objects with keys, sizes, ETags, and last modified dates.