Struct aws_config::meta::region::RegionProviderChain

pub struct RegionProviderChain { /* private fields */ }

Load a region by selecting the first from a series of region providers.

Examples

use aws_types::region::Region;
use std::env;
use aws_config::meta::region::RegionProviderChain;

// region provider that first checks the `CUSTOM_REGION` environment variable,
// then checks the default provider chain, then falls back to us-east-2
let provider = RegionProviderChain::first_try(env::var("CUSTOM_REGION").ok().map(Region::new))
    .or_default_provider()
    .or_else(Region::new("us-east-2"));

Implementations

impl RegionProviderChain

pub async fn region(&self) -> Option<Region>

Load a region from the provider chain

The first provider to return a non-optional region will be selected

pub fn first_try(provider: impl ProvideRegion + 'static) -> Self

Create a default provider chain that starts by checking this provider.

pub fn or_else(self, fallback: impl ProvideRegion + 'static) -> Self

Add a fallback provider to the region provider chain.

pub fn default_provider() -> Self

Create a region provider chain that starts by checking the default provider.

pub fn or_default_provider(self) -> Self

Fallback to the default provider

Trait Implementations

impl Debug for RegionProviderChain

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ProvideRegion for RegionProviderChain

fn region(&self) -> ProvideRegion<'_>

Load a region from this provider