Struct ObjectUrl 

pub struct ObjectUrl {
    pub scheme: CloudScheme,
    pub bucket: String,
    pub key: String,
    pub region: Option<String>,
    pub endpoint: Option<String>,
}

A parsed cloud object URL.

Fields

scheme: CloudScheme

Scheme of the URL.

bucket: String

Bucket or container name.

key: String

Object key / path within the bucket.

region: Option<String>

AWS / GCS region (if present in the URL).

endpoint: Option<String>

Custom endpoint override.

Implementations

impl ObjectUrl

pub fn parse(url: &str) -> Result<Self, CloudError>

Parse a cloud URL string into an ObjectUrl.

Supported forms:

• s3://bucket/key
• gs://bucket/key
• az://container/blob
• abfs://container@account.dfs.core.windows.net/path
• http://host/path
• https://host/path

pub fn to_https_url(&self, endpoint_override: Option<&str>) -> String

Convert the cloud URL to an HTTPS URL.

• S3: https://{bucket}.s3.{region}.amazonaws.com/{key}
• GCS: https://storage.googleapis.com/{bucket}/{key}
• Azure: https://{account}.blob.core.windows.net/{container}/{key}
• HTTP/HTTPS: return as-is (upgraded to https for http)

pub fn signing_host(&self) -> String

Build the canonical host string used when signing requests.

pub fn signing_path(&self) -> String

Return the URL path component used for signing.

Trait Implementations

impl Clone for ObjectUrl

fn clone(&self) -> ObjectUrl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ObjectUrl

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

Formats the value using the given formatter.

impl PartialEq for ObjectUrl

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for ObjectUrl

impl StructuralPartialEq for ObjectUrl