Crate aws_config
source · [−]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:
SdkConfig
. SdkConfig
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);
Override configuration after construction of SdkConfig
:
let sdk_config = aws_config::load_from_env().await;
let custom_credentials_provider = custom_provider(&sdk_config);
let dynamo_config = aws_sdk_dynamodb::config::Builder::from(&sdk_config)
.credentials_provider(custom_credentials_provider)
.build();
let client = aws_sdk_dynamodb::Client::from_conf(dynamo_config);
Modules
Functionality related to creating new HTTP Connectors
Credentials Provider for external process
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
This module defines types that describe when to retry given a response.
SSO Credentials Provider
Credential provider augmentation through the AWS Security Token Service (STS).
This module defines types that describe timeouts that can be applied to various stages of the
Smithy networking stack.
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.
Load a cross-service
SdkConfig
from the environmentError for when an app name doesn’t meet character requirements.
AWS Shared Configuration
Functions
Create an environment loader for AWS Configuration
Load a default configuration from the environment