Enum Region 

pub enum Region {
    UsEast1,
    UsEast2,
    UsWest2,
    EuWest1,
    ApNortheast1,
    Unlisted(String),
}

An AWS region, by its name.

Built by parsing ("eu-central-1".parse::<Region>()), from the environment (Region::from_env), or from a constant (Region::US_EAST_1). Equality is by name, so a parsed "us-east-1" equals the constant. Read a region with Region::as_str rather than matching on its variants, which are deprecated (see the module docs).

Variants

UsEast1

👎Deprecated since 1.3.0:

use Region::US_EAST_1; Region’s variants go no earlier than 2.0.0 (#743)

UsEast2

👎Deprecated since 1.3.0:

use Region::US_EAST_2; Region’s variants go no earlier than 2.0.0 (#743)

UsWest2

👎Deprecated since 1.3.0:

use Region::US_WEST_2; Region’s variants go no earlier than 2.0.0 (#743)

EuWest1

👎Deprecated since 1.3.0:

use Region::EU_WEST_1; Region’s variants go no earlier than 2.0.0 (#743)

ApNortheast1

👎Deprecated since 1.3.0:

use Region::AP_NORTHEAST_1; Region’s variants go no earlier than 2.0.0 (#743)

Unlisted(String)

👎Deprecated since 1.3.0:

parse the name with name.parse::<Region>() and read it with as_str; Region’s variants go no earlier than 2.0.0 (#743)

Any region outside the five above, by name.

Since 1.3.0 every well-formed name outside the five parses to this, whether or not AWS was measured running MicroVMs there; Region::is_measured says which.

Implementations

impl Region

pub const US_EAST_1: Region = Region::UsEast1

pub const US_EAST_2: Region = Region::UsEast2

pub const US_WEST_2: Region = Region::UsWest2

pub const EU_WEST_1: Region = Region::EuWest1

pub const AP_NORTHEAST_1: Region = Region::ApNortheast1

impl Region

pub fn as_str(&self) -> &str

The wire spelling, which is also the endpoint’s middle segment.

pub fn is_measured(&self) -> bool

Whether AWS was measured running MicroVMs here: membership in MEASURED_REGIONS.

False means unmeasured, not refused. The region still works when AWS runs MicroVMs there; what it changes is what a null-message AccessDeniedException there most likely means.

pub fn is_supported(&self) -> bool

👎Deprecated since 1.3.0:

AWS runs MicroVMs in more regions than the five named ones: use is_measured (#743)

Whether this is one of the five named regions.

pub fn unlisted(name: impl Into<String>) -> Region

👎Deprecated since 1.3.0:

every well-formed region name parses: use name.parse::<Region>()

A region by name, without the shape check.

Every well-formed name parses since 1.3.0, so this is str::parse without its refusal of a malformed name. A named region’s name comes back as its constant, so unlisted("us-east-1") == Region::US_EAST_1.

pub fn from_env(env: &dyn Fn(&str) -> Option<String>) -> Result<Region, Error>

The region the environment names: $AWS_REGION, then $AWS_DEFAULT_REGION, then us-east-1.

Parsed rather than accepted, because an environment variable is where a stray space or a case change arrives. env is a lookup rather than std::env::var so a caller (and a test) decides where the variables come from. The CLI’s region resolution and microvms_core::preflight::preflight both read it here.

Trait Implementations

impl Clone for Region

fn clone(&self) -> Region

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Region

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

Formats the value using the given formatter.

impl Display for Region

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

Formats the value using the given formatter.

impl Eq for Region

impl FromStr for Region

fn from_str(name: &str) -> Result<Region, Error>

Parses any well-formed region name, and refuses a malformed one.

A named region’s name comes back equal to its constant.

type Err = Error

The associated error which can be returned from parsing.

impl Hash for Region

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Region

fn eq(&self, other: &Region) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Region