#object-storage #amazon-s3 #s3-compatible #s3 #wasabi #gcp #storage-api


Rust library for working with AWS S3 and compatible object storage APIs

127 releases

new 0.35.0-alpha.2 Jun 17, 2024
0.34.0 Jun 14, 2024
0.34.0-rc4 Oct 17, 2023
0.34.0-beta3 Apr 10, 2023
0.2.3 Jul 8, 2016

#33 in Network programming

Download history 24979/week @ 2024-03-04 24549/week @ 2024-03-11 22645/week @ 2024-03-18 20954/week @ 2024-03-25 19807/week @ 2024-04-01 19644/week @ 2024-04-08 21715/week @ 2024-04-15 21139/week @ 2024-04-22 20236/week @ 2024-04-29 19371/week @ 2024-05-06 20700/week @ 2024-05-13 18829/week @ 2024-05-20 17356/week @ 2024-05-27 21521/week @ 2024-06-03 18740/week @ 2024-06-10 16257/week @ 2024-06-17

74,673 downloads per month
Used in 42 crates (33 directly)

MIT license


build MIT licensed

rust-s3 [docs]

Rust library for working with Amazon S3 or arbitrary S3 compatible APIs, fully compatible with async/await and futures ^0.3. All async features can be turned off and sync only implementations can be used.

Support further development

  • BTC - bc1q0m5e0xa0sy8rerwuvjgvsqt4v2cdmknd3w653k
  • ETH - 0xbcaE345BB362Ff81E4b5C7c1041Fd81Bb6F1f901


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

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.

Quick Start

Read and run examples from the examples folder, make sure you have valid credentials for the variant you're running.

# tokio, default
cargo run --example tokio

# async-std
cargo run --example async-std --no-default-features --features async-std-native-tls

# sync
cargo run --example sync --no-default-features --features sync-native-tls

# minio
cargo run --example minio

# r2
cargo run --example r2

# google cloud
cargo run --example google-cloud


There are a lot of various features that enable a wide variety of use cases, refer to s3/Cargo.toml for an exhaustive list. Below is a table of various useful features as well as a short description for each.

  • default - tokio runtime and a native-tls implementation
  • blocking - generates *_blocking variant of all Bucket methods, otherwise only async versions are available
  • fail-on-err - return Result::Err for HTTP errors
  • no-verify-ssl - disable SSL verification for endpoints, useful for custom regions
  • never-encode-slash - never encode slashes in paths
With default-features = false
  • with-async-std - async-std runtime
  • sync - no async runtime, attohttpc is used for HTTP requests
  • tags - required for Bucket::get_object_tagging

All runtimes support either native-tls or rustls-tls, there are features for all combinations, refer to s3/Cargo.toml for a complete list.

Path or subdomain style URLs and headers

Bucket struct provides constructors for path-style paths, subdomain style is the default. Bucket exposes methods for configuring and accessing path-style configuration. blocking feature will generate a *_blocking variant of all the methods listed below.


create async
delete async
list async
exists async


POST presign_post
PUT presign_put
GET presign_get
DELETE presign_delete


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

async/sync/async-blocking get_object
async/sync/async-blocking get_object_stream
async/sync/async-blocking get_object_to_writer


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

async/sync/async-blocking put_object
async/sync/async-blocking put_object_with_content_type
async/sync/async-blocking put_object_stream


async/sync/async-blocking list


async/sync/async-blocking delete_object


async/sync/async-blocking location


async/sync/async-blocking put_object_tagging
async/sync/async-blocking get_object_tagging


async/sync/async-blocking head_object

Usage (in Cargo.toml)

rust-s3 = "0.34"


~360K SLoC