Lib.rs

rust-s3 [文档]

Rust 库，用于处理 Amazon S3 或任意兼容 S3 的 API，完全兼容 async/await 和 futures ^0.3。所有 async 功能都可以关闭，并可以使用仅同步的实现。

支持进一步开发

• BTC - bc1q0m5e0xa0sy8rerwuvjgvsqt4v2cdmknd3w653k
• ETH - 0xbcaE345BB362Ff81E4b5C7c1041Fd81Bb6F1f901

简介

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

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

快速入门

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

# 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

特性

有很多不同的特性，可以支持各种用例，请参阅 s3/Cargo.toml 以获取完整的列表。以下是一个各种有用特性的表格，以及每个特性的简要描述。

• default - tokio 运行时和 native-tls 实现
• blocking - 为所有 Bucket 方法生成 *_blocking 变体，否则只有 async 版本可用
• fail-on-err - 对于 HTTP 错误返回 Result::Err
• no-verify-ssl - 禁用端点的 SSL 验证，对于自定义区域很有用
• never-encode-slash - 永远不对路径中的反斜杠进行编码

使用 default-features = false

• with-async-std - async-std 运行时
• sync - 没有异步运行时，使用 attohttpc 进行 HTTP 请求
• tags - 需要 Bucket::get_object_tagging

所有运行时都支持 native-tls 或 rustls-tls，所有组合都有功能，有关完整列表，请参阅 s3/Cargo.toml

路径或子域样式 URL 和头

Bucket 结构体提供了 path-style 路径的构造函数，subdomain 风格是默认的。 Bucket 提供了配置和访问 path-style 配置的方法。 blocking 功能将生成以下所有方法的 *_blocking 变体。

存储桶

预签名

GET

获取对象有几种不同的选项。 sync 和 async 方法在 std::io::Write 上是一致的，而 tokio 方法在 tokio::io::AsyncWriteExt 上是一致的。

PUT

每个 GET 方法都有一个对应的 PUT 方法。 sync 和 async 方法在 std::io::Read 上是一致的。 async stream 方法在 futures_io::AsyncReadExt 上是一致的，而 tokio 方法在 tokio::io::AsyncReadExt 上是一致的。

列表

DELETE

位置

标记

头部

使用（在 Cargo.toml 中）

[dependencies]
rust-s3 = "0.34"