Rust library for interfacing with AWS S3 and other API compatible services
Rust library for working with Amazon S3 or arbitrary S3 compatible APIs, fully compatible with async/await and
futures ^0.3
3QQdtQGSMStTWEBhe65hPiAWJekXH8n26o
0x369Fd06ACc25CCfE0A28BE40018cF3aC38AcdcB6
Modest interface towards Amazon S3, as well as S3 compatible object storage APIs such as Wasabi, Yandex, Minio or Google Cloud Storage. Supports:
put,
get,
list,
delete, operations on
tagsand
location, well as
head.
Additionally a dedicated
presign_get
Bucketmethod 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
PUTpresigned URL, meaning they can upload to a specific key in S3 for the duration of the presigned URL.
AWS, Yandex and Custom (Minio) Example
Bucketstruct provides constructors for
path-stylepaths,
subdomainstyle is the default.
Bucketexposes methods for configuring and accessing
path-styleconfiguration.
| | | |----------|-----------------------------------------------------------------------------| |
create| async | |
delete| async |
| | | |-------|----------------------------------------------------------------------------------------| |
PUT| presign_put | |
GET| presign_get |
There are a few different options for getting an object.
syncand
asyncmethods are generic over
std::io::Write, while
tokiomethods are generic over
tokio::io::AsyncWriteExt.
| | | |---------|----------------------------------------------------------------------------------------------------| |
async| get_object | |
async| getobjectstream |
Each
GETmethod has a
PUTcompanion
syncand
asyncmethods are generic over
std::io::Read.
async
streammethods are generic over
futures::io::AsyncReadExt, while
tokiomethods are generic over
tokio::io::AsyncReadExt.
| | | |---------|--------------------------------------------------------------------------------------------------------------------------| |
async| put_object | |
async| putobjectwithcontenttype | |
async| putobjectstream |
| | | |---------|--------------------------------------------------------------------------| |
async| list |
| | | |---------|--------------------------------------------------------------------------------------------| |
async| delete_object |
| | | |---------|----------------------------------------------------------------------------------| |
async| location |
| | | |---------|------------------------------------------------------------------------------------------------------| |
async| putobjecttagging | |
async| getobjecttagging |
| | | |---------|----------------------------------------------------------------------------------------| |
async| head_object |
Cargo.toml)
[dependencies] rust-s3 = "0.27"
[dependencies] rust-s3 = {version = "0.26.0", features = ["no-verify-ssl"]}
[dependencies] rust-s3 = {version = "0.26.0", features = ["fail-on-err"]}
Default is
reqwest/native-tls, it is possible to switch to
reqwest/rustls-tlswhich is more portable
[dependencies] rust-s3 = {version = "0.26.0", features = ["rustls-tls"]}