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 url(&self) -> &EndpointUrl

Returns the validated endpoint URL.

pub fn is_https(&self) -> bool

Returns whether this endpoint uses HTTPS.

pub fn object_url( &self, bucket: &str, object_key: Option<&str>, style: AddressingStyle, ) -> Result<EndpointUrl, S3Error>

Builds an encoded bucket or object URL using the requested addressing style.

Errors

Returns an error when the bucket is invalid for the selected addressing style or the resulting URL is not a valid absolute HTTP URI.

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