s3-tokio 文档

用于操作 Amazon S3 或任意 S3 兼容 API 的 Rust 库，完全兼容 async/await 和 futures ^0.3。

仅支持 tokio 和 rustls。

[!NOTE] 此存储库是 rust-s3-async(是 rust-s3 的分支) 的分支，但只支持 tokio 和 rustls。还更新了依赖项。（例如 hyper ^1）

简介

面向 Amazon S3 的简单接口，以及 Backblaze B2、Wasabi、Yandex、Minio、Cloudflare R2 或 Google Cloud Storage 等兼容 S3 的对象存储 API。支持：put、get、list、delete、对 tags 和 location 的操作，以及 head。

此外，还有一个专门的 presign_get Bucket 方法。这意味着您可以将文件上传到 S3，并给选定的链接而不必担心 S3 上的公开文件。这也意味着您可以提供 PUT 预签名 URL，这意味着他们可以在预签名 URL 期间将文件上传到 S3 的特定键。

快速入门

阅读并运行 examples 文件夹中的示例，确保您有运行所使用的有效凭证。

# tokio, default
cargo run --example tokio

# minio
# First, start Minio on port 9000.
AWS_ACCESS_KEY_ID="minioadmin" \
AWS_SECRET_ACCESS_KEY="minioadmin" \
    cargo run --example minio

# r2
cargo run --example r2

# google cloud
cargo run --example google-cloud

功能

有很多各种功能，可以满足各种用例，请参阅 s3/Cargo.toml 获取完整列表。以下是各种有用功能的表格以及每个功能的简短描述。

• default - 仅在出错时失败
• fail-on-err - 在任何错误上引发恐慌
• no-verify-ssl - 禁用端点的SSL验证，适用于自定义区域

路径或子域样式URL和头信息

Bucket 结构体提供了对 path-style 路径的构造函数，默认是 subdomain 样式。Bucket 提供了配置和访问 path-style 配置的方法。

存储桶

预签名

GET

获取对象有多种选项，方法对 tokio::io::AsyncWriteExt 是通用的。

PUT

每个 GET 方法都有一个对应的 PUT 方法，并且 tokio 方法对 tokio::io::AsyncReadExt 是通用的。

列表

DELETE

位置

标签

头部

使用（在 Cargo.toml 中）

[dependencies]
s3-tokio = "0.39"