Rusoto Core

Rusoto 是 Rust 的 AWS SDK

你可能正在寻找

• Rusoto 概述
• 支持 Rusoto 的 AWS 服务
• API 文档
• 获取 Rusoto 帮助

安装

Rusoto 可在 crates.io 上使用。要在使用 Cargo 构建的 Rust 程序中使用 Rusoto，将其作为依赖项添加，并使用 rusoto_$SERVICENAME 为你想要使用的任何支持的 AWS 服务。

例如，仅包括 S3 和 SQS

[dependencies]
rusoto_core = "0.48.0"
rusoto_sqs = "0.48.0"
rusoto_s3 = "0.48.0"

迁移说明

重大变更和迁移细节在 https://rusoto.org/migrations.html 中有文档记录。

请注意，从 v0.43.0 开始，Rusoto 使用 Rust 的 std::future::Future 和 Tokio 0.2 生态系统。

使用方法

Rusoto 为每个 AWS 服务都有一个 crate，包含该服务 API 的 Rust 类型。这些服务的完整列表可以在 此处 找到。所有其他公共类型都重新导出到 crate 根。通过运行 cargo doc 或访问在线 文档 获取完整详细信息。

使用 Rusoto 的 DynamoDB API 列出数据库中所有表的名称的简单示例

use rusoto_core::Region;
use rusoto_dynamodb::{DynamoDb, DynamoDbClient, ListTablesInput};

#[tokio::main]
async fn main() {
    let client = DynamoDbClient::new(Region::UsEast1);
    let list_tables_input: ListTablesInput = Default::default();

    match client.list_tables(list_tables_input).await {
        Ok(output) => match output.table_names {
            Some(table_name_list) => {
                println!("Tables in database:");

                for table_name in table_name_list {
                    println!("{}", table_name);
                }
            }
            None => println!("No tables in database!"),
        },
        Err(error) => {
            println!("Error: {:?}", error);
        }
    }
}

与 rustls 一起使用

如果你不想使用 OpenSSL，你可以通过编辑你的 Cargo.toml 用 rustls 替换它

[dependencies]
rusoto_core = { version="0.48.0", default_features=false, features=["rustls"] }
rusoto_sqs = { version="0.48.0", default_features=false, features=["rustls"] }
rusoto_s3 = { version="0.48.0", default_features=false, features=["rustls"] }

凭证

有关 Rusoto 使用 AWS 凭据（如优先级和刷新）的更多信息，请参阅 AWS 凭证。

语义版本

Rusoto 遵循 语义化版本控制 2.0.0。在达到 1.0.0 之前，API 被视为不稳定。请参阅 Cargo.toml 或 rusoto 在 crates.io 上的当前版本。

版本发布

关于发布计划和流程的信息在 RELEASING 中。

贡献

请参阅 CONTRIBUTING。

支持的操作系统和 Rust 版本

Linux、OSX 和 Windows 都受支持并通过 Azure Pipelines 和 Appveyor 进行测试。

支持 Rust 稳定版、beta 版和nightly 版。

许可证

Rusoto 在 MIT 许可证的条款下分发。

有关详细信息，请参阅 LICENSE。