Struct aws_sdk_rust::aws::s3::endpoint::Endpoint

pub struct Endpoint {
    pub region: Region,
    pub signature: Signature,
    pub endpoint: Option<Url>,
    pub proxy: Option<Url>,
    pub user_agent: Option<String>,
}

Endpoint allows you to set a custom endpoint and/or a proxy for a given region and associate this as an endpoint of where S3Client will look for the data.

Fields

region: Region

Specify the specific Region you're targeting the request towards. The default is: Region::UsEast1. This value should be Region::UsEast1 for third party services since some do not use Region information for their Endpoint.

signature: Signature

Signature is an enum of V2 or V4. Specify Signature::V2 or Signature::V4. See notes below.

endpoint: Option<Url>

Uses Url crate. AWS has a fixed set of Endpoints. However, third party services also need to be covered so adding an option for the Endpoint solves that requirement. If using AWS then it will default to the given Endpoint for the specified Region.

proxy: Option<Url>

Important: Proxies are used by most Enterprises. You can specify your proxy with the port in the following format https://:. Also, it honors the http_proxy, https_proxy and no_proxy environment variables if present. However, manually setting the value takes precedent.

user_agent: Option<String>

User-Agent. It lives in Endpoint since you may want a different User-Agent for Endpoint. This value is an Option which can be None.

Methods

impl Endpoint

fn new(region: Region, signature: Signature, endpoint: Option<Url>, proxy: Option<Url>, user_agent: Option<String>) -> Self

Endpoint::new accepts Region, Signature, an optional Url and an optional proxy Url:port.

fn hostname(&self) -> Option<String>

Extracts out the host portion of the URL as defined by the crate Url.

Trait Implementations

impl Clone for Endpoint

fn clone(&self) -> Endpoint

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Endpoint

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.