Rust library for working with Amazon S3 or arbitrary S3 compatible APIs, fully compatible with async/await and futures ^0.3
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.
AWS, Yandex and Custom (Minio) Example
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 | getobject |
| async | getobjectstream |
| sync | getobjectblocking |
| sync | getobjectstreamblocking |
| tokio | tokiogetobject_stream |
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 | putobject |
| async | putobjectstream |
| sync | putobjectblocking |
| sync | putobjectstreamblocking |
| tokio | tokioputobject_stream |
The main cool feature is that put commands return a presigned link to the file you uploaded
This means you can upload to s3, and give the link to select people without having to worry about publicly accessible files on S3.
Getter and setter functions exist for all Link params... You don't really have to touch anything there, maybe amz-expire,
it is configured for one week which is the maximum Amazon allows ATM.
Cargo.toml)toml
[dependencies]
rust-s3 = "0.22.3"
toml
[dependencies]
rust-s3 = {version = "0.22.3", features = ["no-verify-ssl"]}
toml
[dependencies]
rust-s3 = {version = "0.22.3", features = ["fail-on-err"]}
toml
[dependencies]
rust-s3 = {version = "0.22.3", features = ["path-style"]}