Struct aws_config::meta::credentials::lazy_caching::Builder

pub struct Builder { /* fields omitted */ }

Builder for constructing a LazyCachingCredentialsProvider.

Examples

use aws_types::Credentials;
use aws_config::meta::credentials::provide_credentials_fn;
use aws_config::meta::credentials::LazyCachingCredentialsProvider;

let provider = LazyCachingCredentialsProvider::builder()
    .load(provide_credentials_fn(|| async {
        // An async process to retrieve credentials would go here:
        Ok(Credentials::from_keys("example", "example", None))
    }))
    .build();

Implementations

impl Builder

pub fn new() -> Self

Creates a new builder

pub fn configure(self, config: &ProviderConfig) -> Self

Override configuration for the Builder

pub fn load(self, loader: impl ProvideCredentials + 'static) -> Self

An implementation of ProvideCredentials that will be used to load the cached credentials once they’re expired.

pub fn sleep(self, sleep: impl AsyncSleep + 'static) -> Self

Implementation of AsyncSleep to use for timeouts. This enables use of the LazyCachingCredentialsProvider with other async runtimes. If using Tokio as the async runtime, this should be set to an instance of TokioSleep.

pub fn load_timeout(self, timeout: Duration) -> Self

(Optional) Timeout for the given ProvideCredentials implementation. Defaults to 5 seconds.

pub fn buffer_time(self, buffer_time: Duration) -> Self

(Optional) Amount of time before the actual credential expiration time where credentials are considered expired. For example, if credentials are expiring in 15 minutes, and the buffer time is 10 seconds, then any requests made after 14 minutes and 50 seconds will load new credentials. Defaults to 10 seconds.

pub fn default_credential_expiration(self, duration: Duration) -> Self

(Optional) Default expiration time to set on credentials if they don’t have an expiration time. This is only used if the given ProvideCredentials returns Credentials that don’t have their expiry set. This must be at least 15 minutes.

pub fn build(self) -> LazyCachingCredentialsProvider

Creates the LazyCachingCredentialsProvider.

Panics

This will panic if no sleep implementation is given and if no default crate features are used. By default, the TokioSleep implementation will be set automatically.

Trait Implementations

impl Default for Builder

fn default() -> Builder

Returns the “default value” for a type.