Expand description

aws-config provides implementations of region, credential resolution.

These implementations can be used either via the default chain implementation from_env/ConfigLoader or ad-hoc individual credential and region providers.

ConfigLoader can combine different configuration sources into an AWS shared-config: Config. Config can be used configure an AWS service client.

Examples

Load default SDK configuration:

let config = aws_config::load_from_env().await;
let client = aws_sdk_dynamodb::Client::new(&config);

Load SDK configuration with a region override:

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);

Modules

Functionality related to creating new HTTP Connectors

Providers that implement the default AWS provider chain Default Provider chains for region, credentials, retries, timeouts and app name.

Ecs Credentials Provider

Providers that load configuration from environment variables

IMDSv2 Client, credential, and region provider

Meta-providers that augment existing providers with new behavior

Load configuration from AWS Profiles

Configuration Options for Credential Providers

SSO Credentials Provider

Credential provider augmentation through the AWS Security Token Service (STS).

Load Credentials from Web Identity Tokens

Structs

App name that can be configured with an AWS SDK client to become part of the user agent string.

AWS Shared Configuration

Load a cross-service Config from the environment

Error for when an app name doesn’t meet character requirements.

Retry configuration for requests.

Configuration for timeouts

Functions

Create an environment loader for AWS Configuration

Load a default configuration from the environment