Struct RegionalState 

pub struct RegionalState<T> { /* private fields */ }

One account’s state for a regional service, partitioned by region.

Regional AWS services (SQS, DynamoDB, Lambda, …) keep an independent set of resources in every region: the same queue, table or function name can exist in two regions at once, and a request only ever sees the resources of the region it is sent to. Wrapping a service’s per-account state T in RegionalState<T> (and the container in MultiRegionState) gives every (account, region) pair its own T, created the first time a request targets it.

Global services (IAM, Route 53, CloudFront, Organizations, the S3 bucket namespace) stay account-scoped and do not use this wrapper.

Implementations

impl<T> RegionalState<T>

pub fn new(account_id: &str, default_region: &str, endpoint: &str) -> Self

An account with no regional state yet.

pub fn account_id(&self) -> &str

The account this state belongs to.

pub fn default_region(&self) -> &str

The server’s configured region.

pub fn endpoint(&self) -> &str

The server endpoint.

pub fn region(&self, region: &str) -> Option<&T>

The account’s state in region, None when nothing has touched it.

pub fn get_region_mut(&mut self, region: &str) -> Option<&mut T>

The account’s state in region without creating it.

pub fn regions(&self) -> impl Iterator<Item = (&str, &T)>

Every region the account has state in.

pub fn regions_mut(&mut self) -> impl Iterator<Item = (&str, &mut T)>

Every region the account has state in (mutable).

pub fn insert_region(&mut self, region: &str, state: T) -> Option<T>

Replace (or add) the state of one region.

pub fn clear(&mut self)

Drop every region’s state.

pub fn map<U>(&self, f: impl FnMut(&T) -> U) -> RegionalState<U>

Project every region’s state, keeping the account’s routing defaults.

impl<T: AccountState> RegionalState<T>

pub fn region_mut(&mut self, region: &str) -> &mut T

The account’s state in region, created empty on first use. A new region inherits shared resources (see AccountState::inherit_from) from a region the account already has.

pub fn region_or_default_mut(&mut self, region: Option<&str>) -> &mut T

The state for region given as an optional ARN region: None (an ARN without a region, or a record without an ARN) lands in the server’s default region. Used by snapshot migrations.

impl<T: SplitByRegion> RegionalState<T>

pub fn from_legacy( account_id: &str, default_region: &str, endpoint: &str, legacy: T, ) -> Self

Split one account’s legacy, account-wide state into regions.

Trait Implementations

impl<T: AccountState> AccountState for RegionalState<T>

fn new_for_account(account_id: &str, region: &str, endpoint: &str) -> Self

Create a fresh, empty state for the given account.

fn inherit_from(&mut self, sibling: &Self)

Called after a new account state is created via MultiAccountState::get_or_create, with a reference to an existing sibling state. Services can override this to propagate shared resources (e.g. body caches) to the new state.

impl<T: Clone> Clone for RegionalState<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for RegionalState<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for RegionalState<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for RegionalState<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.