rust-s3 [docs]

Rust library for working with Amazon S3 or arbitrary S3 compatible APIs, fully compatible with async/await and futures ^0.3

Intro

Modest interface towards Amazon S3, as well as S3 compatible object storage APIs such as Wasabi, Yandex or Minio. Supports put, get, list, delete, operations on tags and location.

Additionally a dedicated presign_get Bucket method is available. This means you can upload to s3, and give the link to select people without having to worry about publicly accessible files on S3. This also means that you can give people a PUT presigned URL, meaning they can upload to a specific key in S3 for the duration of the presigned URL.

AWS, Yandex and Custom (Minio) Example

Presign

PUT	presign_put
GET	presign_get

GET

There are a few different options for getting an object. async and sync methods are generic over std::io::Write, while tokio methods are generic over tokio::io::AsyncWriteExt.

async	get_object
async	get_object_stream
sync	get_object_blocking
sync	get_object_stream_blocking
tokio	tokio_get_object_stream

PUT

Each GET method has a PUT companion sync and async methods are generic over std::io::Read, while tokio methods are generic over tokio::io::AsyncReadExt.

async	put_object
async	put_object_stream
sync	put_object_blocking
sync	put_object_stream_blocking
tokio	tokio_put_object_stream

List

async	list
sync	list_blocking

DELETE

async	delete_object
sync	delete_object_blocking

Location

async	location
sync	location_blocking

Tagging

async	put_object_tagging
sync	put_object_tagging_blocking
async	get_object_tagging
sync	get_object_tagging_blocking

Usage (in Cargo.toml)

[dependencies]
rust-s3 = "0.22.8"

Disable SSL verification for endpoints, useful for custom regions

[dependencies]
rust-s3 = {version = "0.22.8", features = ["no-verify-ssl"]}

Fail on HTTP error responses

[dependencies]
rust-s3 = {version = "0.22.8", features = ["fail-on-err"]}

Use path style addressing, needed for Minio compatibility

[dependencies]
rust-s3 = {version = "0.22.8", features = ["path-style"]}