65 releases (28 stable)
1.5.10 | Nov 6, 2024 |
---|---|
1.5.7 | Sep 27, 2024 |
1.5.4 | Jul 5, 2024 |
1.1.9 | Mar 26, 2024 |
0.0.26-alpha | Nov 24, 2021 |
#8 in Network programming
1,220,725 downloads per month
Used in 854 crates
(738 directly)
2.5MB
49K
SLoC
aws-config
AWS SDK config and credential provider implementations.
The implementations can be used either via the default chain implementation from_env
/ConfigLoader
or ad-hoc individual credential and region providers.
A ConfigLoader
can combine different configuration sources into an AWS shared-config Config
. The Config
can then be used to configure one or more AWS service clients.
Examples
Load default SDK configuration:
async fn example() {
let config = aws_config::load_from_env().await;
let client = aws_sdk_dynamodb::Client::new(&config);
}
Load SDK configuration with a region override:
use aws_config::meta::region::RegionProviderChain;
async fn example() {
let region_provider = RegionProviderChain::default_provider().or_else("us-east-1");
let config = aws_config::from_env().region(region_provider).load().await;
let client = aws_sdk_dynamodb::Client::new(&config);
}
Getting Started
Examples are available for many services and operations, check out the examples folder in GitHub.
The SDK provides one crate per AWS service. You must add Tokio as a dependency within your Rust project to execute asynchronous code. To add aws-sdk-config to your project, add the following to your Cargo.toml file where VERSION is the version of the SDK you want to use:
[dependencies]
aws-config = "VERSION"
aws-sdk-config = "VERSION"
tokio = { version = "1", features = ["full"] }
Using the SDK
Detailed usage instructions are available in the Developer Guide. Suggestions for additional sections or improvements for the guide are welcome. Please open an issue describing what you are trying to do.
Getting Help
- GitHub discussions - For ideas, RFCs & general questions
- GitHub issues – For bug reports & feature requests
- Generated Docs (latest version)
- Usage examples
License
This project is licensed under the Apache-2.0 License.
This crate is part of the AWS SDK for Rust and the smithy-rs code generator.
Dependencies
~9–22MB
~310K SLoC