Struct Endpoint 

pub struct Endpoint { /* private fields */ }

A validated S3 service endpoint.

Implementations

impl Endpoint

pub fn new(endpoint: impl AsRef<str>) -> Result<Self, S3Error>

Parses and validates an HTTP or HTTPS endpoint.

Errors

Returns an error when the URL is not an absolute HTTP(S) URL, contains credentials, a query, or a fragment, or has no usable host.

pub fn for_aws_region(region: &str) -> Result<Self, S3Error>

Creates the standard regional AWS S3 endpoint.

Errors

Returns an error when region cannot be represented safely in an AWS regional hostname.

pub fn for_aws_region_variant( region: &str, variant: AwsEndpointVariant, ) -> Result<Self, S3Error>

Creates a partition-aware regional AWS S3 endpoint variant.

China regions use the amazonaws.com.cn DNS suffix. Commercial and GovCloud regions use amazonaws.com. The region is still used as the SigV4 signing region by crate::S3Config.

Errors

Returns an error when region cannot be represented safely in an AWS regional hostname.

pub fn as_str(&self) -> &str

Returns the validated endpoint as an absolute URL string.

pub fn is_https(&self) -> bool

Returns whether this endpoint uses HTTPS.

Trait Implementations

impl Clone for Endpoint

fn clone(&self) -> Endpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Endpoint

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

Formats the value using the given formatter.

impl Default for Endpoint

fn default() -> Self

Returns the “default value” for a type.

impl Display for Endpoint

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

Formats the value using the given formatter.

impl Eq for Endpoint

impl FromStr for Endpoint

type Err = S3Error

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

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

impl PartialEq for Endpoint

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Endpoint