29 breaking releases

new 0.31.1 Sep 20, 2023
0.30.0 Aug 23, 2023
0.28.0 May 24, 2023
0.25.0 Mar 30, 2023
0.0.26-alpha Nov 24, 2021

#22 in #aws

Download history 516/week @ 2023-05-31 623/week @ 2023-06-07 1294/week @ 2023-06-14 1558/week @ 2023-06-21 985/week @ 2023-06-28 3138/week @ 2023-07-05 3404/week @ 2023-07-12 3741/week @ 2023-07-19 3464/week @ 2023-07-26 4064/week @ 2023-08-02 3981/week @ 2023-08-09 3093/week @ 2023-08-16 4154/week @ 2023-08-23 3900/week @ 2023-08-30 3164/week @ 2023-09-06 2512/week @ 2023-09-13

14,312 downloads per month
Used in 2 crates

Apache-2.0

6.5MB
100K SLoC

aws-sdk-config

Please Note: The SDK is currently in Developer Preview and is intended strictly for feedback purposes only. Do not use this SDK for production workloads.

Config provides a way to keep track of the configurations of all the Amazon Web Services resources associated with your Amazon Web Services account. You can use Config to get the current and historical configurations of each Amazon Web Services resource and also to get information about the relationship between the resources. An Amazon Web Services resource can be an Amazon Compute Cloud (Amazon EC2) instance, an Elastic Block Store (EBS) volume, an elastic network Interface (ENI), or a security group. For a complete list of resources currently supported by Config, see Supported Amazon Web Services resources.

You can access and manage Config through the Amazon Web Services Management Console, the Amazon Web Services Command Line Interface (Amazon Web Services CLI), the Config API, or the Amazon Web Services SDKs for Config. This reference guide contains documentation for the Config API and the Amazon Web Services CLI commands that you can use to manage Config. The Config API uses the Signature Version 4 protocol for signing requests. For more information about how to sign a request with this protocol, see Signature Version 4 Signing Process. For detailed information about Config features and their associated actions or commands, as well as how to work with Amazon Web Services Management Console, see What Is Config in the Config Developer Guide.

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:

[dependencies]
aws-config = "0.56.1"
aws-sdk-config = "0.31.1"
tokio = { version = "1", features = ["full"] }

Then in code, a client can be created with the following:

use aws_sdk_config as config;

#[::tokio::main]
async fn main() -> Result<(), config::Error> {
    let config = aws_config::load_from_env().await;
    let client = aws_sdk_config::Client::new(&config);

    // ... make some calls with the client

    Ok(())
}

See the client documentation for information on what calls can be made, and the inputs and outputs for each of those calls.

Using the SDK

Until the SDK is released, we will be adding information about using the SDK to the Developer Guide. Feel free to suggest additional sections for the guide by opening an issue and describing what you are trying to do.

Getting Help

License

This project is licensed under the Apache-2.0 License.

Dependencies

~10–24MB
~357K SLoC