Struct aws_types::sdk_config::Builder

source · [−]

pub struct Builder { /* private fields */ }

Expand description

Builder for AWS Shared Configuration

Implementations

source

impl Builder

source

pub fn region(self, region: impl Into<Option<Region>>) -> Self

Set the region for the builder

Examples

use aws_types::SdkConfig;
use aws_types::region::Region;
let config = SdkConfig::builder().region(Region::new("us-east-1")).build();

source

pub fn set_region(&mut self, region: impl Into<Option<Region>>) -> &mut Self

Set the region for the builder

Examples

fn region_override() -> Option<Region> {
    // ...
}
use aws_types::SdkConfig;
use aws_types::region::Region;
let mut builder = SdkConfig::builder();
if let Some(region) = region_override() {
    builder.set_region(region);
}
let config = builder.build();

source

pub fn endpoint_resolver(
self,
endpoint_resolver: impl ResolveAwsEndpoint + 'static
) -> Self

Set the endpoint resolver to use when making requests

Examples

use std::sync::Arc;
use aws_types::SdkConfig;
use aws_smithy_http::endpoint::Endpoint;
use http::Uri;
let config = SdkConfig::builder().endpoint_resolver(
    Endpoint::immutable(Uri::from_static("http://localhost:8080"))
).build();

source

pub fn set_endpoint_resolver(
&mut self,
endpoint_resolver: Option<Arc<dyn ResolveAwsEndpoint>>
) -> &mut Self

Set the endpoint resolver to use when making requests

Examples

use std::sync::Arc;
use aws_types::SdkConfig;
use aws_types::endpoint::ResolveAwsEndpoint;
fn endpoint_resolver_override() -> Option<Arc<dyn ResolveAwsEndpoint>> {
    // ...
}
let mut config = SdkConfig::builder();
config.set_endpoint_resolver(endpoint_resolver_override());
config.build();

source

pub fn retry_config(self, retry_config: RetryConfig) -> Self

Set the retry_config for the builder

Examples

use aws_types::SdkConfig;
use aws_smithy_types::retry::RetryConfig;

let retry_config = RetryConfig::new().with_max_attempts(5);
let config = SdkConfig::builder().retry_config(retry_config).build();

source

pub fn set_retry_config(
&mut self,
retry_config: Option<RetryConfig>
) -> &mut Self

Set the retry_config for the builder

Examples

use aws_types::sdk_config::{SdkConfig, Builder};
use aws_smithy_types::retry::RetryConfig;

fn disable_retries(builder: &mut Builder) {
    let retry_config = RetryConfig::new().with_max_attempts(1);
    builder.set_retry_config(Some(retry_config));
}

let mut builder = SdkConfig::builder();
disable_retries(&mut builder);
let config = builder.build();

source

pub fn timeout_config(self, timeout_config: Config) -> Self

Set the timeout::Config for the builder

Examples

use aws_types::SdkConfig;
use aws_smithy_types::{timeout, tristate::TriState};

let api_timeout_config = timeout::Api::new()
    .with_call_attempt_timeout(TriState::Set(Duration::from_secs(2)))
    .with_call_timeout(TriState::Set(Duration::from_secs(5)));
let timeout_config = timeout::Config::new()
    .with_api_timeouts(api_timeout_config);
let config = SdkConfig::builder().timeout_config(timeout_config).build();

source

pub fn set_timeout_config(
&mut self,
timeout_config: Option<Config>
) -> &mut Self

Set the timeout::Config for the builder

Examples

use aws_types::sdk_config::{SdkConfig, Builder};
use aws_smithy_types::{timeout, tristate::TriState};

fn set_preferred_timeouts(builder: &mut Builder) {
    let api_timeout_config = timeout::Api::new()
        .with_call_attempt_timeout(TriState::Set(Duration::from_secs(2)))
        .with_call_timeout(TriState::Set(Duration::from_secs(5)));
    let timeout_config = timeout::Config::new()
        .with_api_timeouts(api_timeout_config);
    builder.set_timeout_config(Some(timeout_config));
}

let mut builder = SdkConfig::builder();
set_preferred_timeouts(&mut builder);
let config = builder.build();

source

pub fn credentials_provider(self, provider: SharedCredentialsProvider) -> Self

Set the credentials provider for the builder

Examples

use aws_types::credentials::{ProvideCredentials, SharedCredentialsProvider};
use aws_types::SdkConfig;
fn make_provider() -> impl ProvideCredentials {
  // ...
}

let config = SdkConfig::builder()
    .credentials_provider(SharedCredentialsProvider::new(make_provider()))
    .build();

source

pub fn set_credentials_provider(
&mut self,
provider: Option<SharedCredentialsProvider>
) -> &mut Self

Set the credentials provider for the builder

Examples

use aws_types::credentials::{ProvideCredentials, SharedCredentialsProvider};
use aws_types::SdkConfig;
fn make_provider() -> impl ProvideCredentials {
  // ...
}

fn override_provider() -> bool {
  // ...
}

let mut builder = SdkConfig::builder();
if override_provider() {
    builder.set_credentials_provider(Some(SharedCredentialsProvider::new(make_provider())));
}
let config = builder.build();