Rusty-S3 使用教程

Rusty-S3 使用教程

rusty-s3Simple pure Rust AWS S3 Client following a Sans-IO approach项目地址:https://gitcode.com/gh_mirrors/ru/rusty-s3

项目介绍

Rusty-S3 是一个纯 Rust 编写的 AWS S3 客户端库，遵循 Sans-IO 方法。这意味着该库本身不发送任何请求，而是由用户选择同步或异步的 HTTP 客户端来发送请求。Rusty-S3 提供了方便的 API 用于签名、构建和解析 AWS S3 请求和响应。

项目快速启动

安装

首先，在 Cargo.toml 文件中添加以下依赖：

[dependencies]
rusty-s3 = "0.5.0"

示例代码

以下是一个基本的快速启动示例，展示了如何设置一个 S3 桶并签名一个请求：

use std::env;
use std::time::Duration;
use rusty_s3::{Bucket, Credentials, S3Action, UrlStyle};

fn main() {
    // 设置一个 bucket
    let endpoint = "https://s3.dualstack.eu-west-1.amazonaws.com".parse().expect("endpoint is a valid Url");
    let path_style = UrlStyle::VirtualHost;
    let name = "rusty-s3";
    let region = "eu-west-1";
    let bucket = Bucket::new(endpoint, path_style, name, region).expect("Url has a valid scheme and host");

    // 设置凭证
    let key = env::var("AWS_ACCESS_KEY_ID").expect("AWS_ACCESS_KEY_ID is set and a valid String");
    let secret = env::var("AWS_SECRET_ACCESS_KEY").expect("AWS_SECRET_ACCESS_KEY is set and a valid String");
    let credentials = Credentials::new(key, secret);

    // 签名一个请求
    let presigned_url_duration = Duration::from_secs(60 * 60);
    let action = bucket.get_object(Some(&credentials), "duck.jpg");
    println!("GET {}", action.sign(presigned_url_duration));
}

应用案例和最佳实践

应用案例

Rusty-S3 可以用于构建各种需要与 AWS S3 交互的应用，例如：

• 静态网站托管
• 数据备份和恢复
• 文件存储和分发

最佳实践

• 使用环境变量管理凭证：如示例代码所示，使用环境变量来管理 AWS 访问密钥和秘密密钥，以提高安全性。
• 选择合适的 URL 风格：根据需求选择 VirtualHost 或 PathStyle URL 风格。
• 设置合理的预签名 URL 有效期：根据业务需求设置合理的预签名 URL 有效期，以平衡安全性和便利性。

典型生态项目

Rusty-S3 可以与其他 Rust 生态项目结合使用，例如：

• reqwest：一个强大的 HTTP 客户端库，用于发送实际的 S3 请求。
• tokio：一个异步运行时，用于处理异步请求。
• serde：用于序列化和反序列化数据。

通过这些生态项目的结合，可以构建出高效、可靠的 S3 交互应用。

rusty-s3Simple pure Rust AWS S3 Client following a Sans-IO approach项目地址:https://gitcode.com/gh_mirrors/ru/rusty-s3