Enum s3_sync::Region

pub enum Region {
    ApEast1,
    ApNortheast1,
    ApNortheast2,
    ApNortheast3,
    ApSouth1,
    ApSoutheast1,
    ApSoutheast2,
    CaCentral1,
    EuCentral1,
    EuWest1,
    EuWest2,
    EuWest3,
    EuNorth1,
    MeSouth1,
    SaEast1,
    UsEast1,
    UsEast2,
    UsWest1,
    UsWest2,
    UsGovEast1,
    UsGovWest1,
    CnNorth1,
    CnNorthwest1,
    Custom {
        name: String,
        endpoint: String,
    },
}

An AWS region.

Default

Region implements the Default trait. Calling Region::default() will attempt to read the AWS_DEFAULT_REGION or AWS_REGION environment variable. If it is malformed, it will fall back to Region::UsEast1. If it is not present it will fallback on the value associated with the current profile in ~/.aws/config or the file specified by the AWS_CONFIG_FILE environment variable. If that is malformed of absent it will fall back on Region::UsEast1

AWS-compatible services

Region::Custom can be used to connect to AWS-compatible services such as DynamoDB Local or Ceph.

    Region::Custom {
        name: "eu-east-3".to_owned(),
        endpoint: "http://localhost:8000".to_owned(),
    };

Caveats

CnNorth1 is currently untested due to Rusoto maintainers not having access to AWS China.

Variants

ApEast1

Region that covers the Eastern part of Asia Pacific

ApNortheast1

Region that covers the North-Eastern part of Asia Pacific

ApNortheast2

Region that covers the North-Eastern part of Asia Pacific

ApNortheast3

Region that covers the North-Eastern part of Asia Pacific

ApSouth1

Region that covers the Southern part of Asia Pacific

ApSoutheast1

Region that covers the South-Eastern part of Asia Pacific

ApSoutheast2

Region that covers the South-Eastern part of Asia Pacific

CaCentral1

Region that covers Canada

EuCentral1

Region that covers Central Europe

EuWest1

Region that covers Western Europe

EuWest2

Region that covers Western Europe

EuWest3

Region that covers Western Europe

EuNorth1

Region that covers Northern Europe

MeSouth1

Bahrain, Middle East South

SaEast1

Region that covers South America

UsEast1

Region that covers the Eastern part of the United States

UsEast2

Region that covers the Eastern part of the United States

UsWest1

Region that covers the Western part of the United States

UsWest2

Region that covers the Western part of the United States

UsGovEast1

Region that covers the Eastern part of the United States for the US Government

UsGovWest1

Region that covers the Western part of the United States for the US Government

CnNorth1

Region that covers China

CnNorthwest1

Region that covers North-Western part of China

Custom

Fields

name: String

Name of the endpoint (e.g. "eu-east-2").

endpoint: String

Endpoint to be used. For instance, "https://s3.my-provider.net" or just "s3.my-provider.net" (default scheme is https).

Specifies a custom region, such as a local Ceph target

Implementations

impl Region

pub fn name(&self) -> &str

Name of the region

    assert_eq!(Region::CaCentral1.name(), "ca-central-1");
    assert_eq!(
        Region::Custom { name: "eu-east-3".to_owned(), endpoint: "s3.net".to_owned() }.name(),
        "eu-east-3"
    );

Trait Implementations

impl Clone for Region

fn clone(&self) -> Region

Returns a copy 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 Default for Region

fn default() -> Region

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Region

fn deserialize<D>(
    deserializer: D
) -> Result<Region, <D as Deserializer<'de>>::Error>where
    D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromStr for Region

type Err = ParseRegionError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Region, ParseRegionError>

Parses a string s to return a value of this type.

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<Region> for Region

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Region

fn serialize<S>(
    &self,
    serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
    S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Region

impl StructuralEq for Region

impl StructuralPartialEq for Region