Struct EndPoint

#[non_exhaustive]
pub struct EndPoint { /* private fields */ }

OSS 的可用区

aliyun docs

Implementations

impl EndPoint

pub const CN_HANGZHOU: Self

杭州

pub const HANGZHOU: Self = Self::CN_HANGZHOU

杭州

pub const CN_SHANGHAI: Self

上海

pub const SHANGHAI: Self = Self::CN_SHANGHAI

上海

pub const CN_QINGDAO: Self

青岛

pub const QINGDAO: Self = Self::CN_QINGDAO

青岛

pub const CN_BEIJING: Self

北京

pub const BEIJING: Self = Self::CN_BEIJING

北京

pub const CN_ZHANGJIAKOU: Self = Self::ZHANGJIAKOU

张家口

pub const ZHANGJIAKOU: Self

张家口

pub const CN_HONGKONG: Self

香港

pub const HONGKONG: Self = Self::CN_HONGKONG

香港

pub const CN_SHENZHEN: Self

深圳

pub const SHENZHEN: Self = Self::CN_SHENZHEN

深圳

pub const US_WEST_1: Self

UsWest1

pub const US_EAST_1: Self

UsEast1

pub const AP_SOUTH_EAST_1: Self

ApSouthEast1

impl<'a> EndPoint

pub fn from_static(url: &'a str) -> Self

通过字符串字面值初始化 endpoint

例如

EndPoint::from_static("qingdao");

pub const unsafe fn from_static2(url: &'static str) -> Self

Safety

用于静态定义其他可用区

pub fn new(url: &'a str) -> Result<Self, InvalidEndPoint>

初始化 endpoint enum

assert!(matches!(
    EndPoint::new("shanghai"),
    Ok(EndPoint::SHANGHAI)
));

assert!(EndPoint::new("abc-").is_err());
assert!(EndPoint::new("-abc").is_err());
assert!(EndPoint::new("abc-def234ab").is_ok());
assert!(EndPoint::new("abc-def*#$%^ab").is_err());
assert!(EndPoint::new("cn-jinan").is_ok());
assert!(EndPoint::new("cn-jinan").is_ok());
assert!(EndPoint::new("oss-cn-jinan").is_err());

pub fn from_env() -> Result<Self, InvalidEndPoint>

use env init Endpoint

pub fn set_internal(&mut self, is_internal: bool)

调整 API 指向是否为内网

当在 Aliyun ECS 上执行时，设为 true 会更高效，默认是 false

pub fn is_internal(&self) -> bool

返回当前的 endpoint 是否为内网

pub fn to_url(&self) -> Url

转化成 Url

use reqwest::Url;
let mut endpoint = EndPoint::new("shanghai").unwrap();
assert_eq!(
    endpoint.to_url(),
    Url::parse("https://oss-cn-shanghai.aliyuncs.com").unwrap()
);

endpoint.set_internal(true);
assert_eq!(
    endpoint.to_url(),
    Url::parse("https://oss-cn-shanghai-internal.aliyuncs.com").unwrap()
);

Trait Implementations

impl AsMut<EndPoint> for BucketBase

fn as_mut(&mut self) -> &mut EndPoint

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T: PointerFamily> AsRef<EndPoint> for Bucket<T>

fn as_ref(&self) -> &EndPoint

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<EndPoint> for BucketBase

fn as_ref(&self) -> &EndPoint

Converts this type into a shared reference of the (usually inferred) input type.

impl<M> AsRef<EndPoint> for Client<M>

fn as_ref(&self) -> &EndPoint

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<EndPoint> for Config

fn as_ref(&self) -> &EndPoint

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: PointerFamily, Item> AsRef<EndPoint> for ObjectList<T, Item>

fn as_ref(&self) -> &EndPoint

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for EndPoint

fn as_ref(&self) -> &str

assert_eq!(EndPoint::HANGZHOU.as_ref(), "cn-hangzhou");
assert_eq!(EndPoint::SHANGHAI.as_ref(), "cn-shanghai");
assert_eq!(EndPoint::QINGDAO.as_ref(), "cn-qingdao");
assert_eq!(EndPoint::BEIJING.as_ref(), "cn-beijing");
assert_eq!(EndPoint::ZHANGJIAKOU.as_ref(), "cn-zhangjiakou");
assert_eq!(EndPoint::HONGKONG.as_ref(), "cn-hongkong");
assert_eq!(EndPoint::SHENZHEN.as_ref(), "cn-shenzhen");
assert_eq!(EndPoint::US_WEST_1.as_ref(), "us-west-1");
assert_eq!(EndPoint::US_EAST_1.as_ref(), "us-east-1");
assert_eq!(EndPoint::AP_SOUTH_EAST_1.as_ref(), "ap-southeast-1");

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EndPoint

fn default() -> EndPoint

Returns the “default value” for a type.

impl Display for EndPoint

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

let mut endpoint = EndPoint::HANGZHOU;
assert_eq!(format!("{}", endpoint), "cn-hangzhou");
endpoint.set_internal(true);
assert_eq!(format!("{}", endpoint), "cn-hangzhou-internal");

impl FromStr for EndPoint

type Err = InvalidEndPoint

The associated error which can be returned from parsing.

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

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

impl Hash for EndPoint

fn hash<__H: Hasher>(&self, state: &mut __H)

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<&str> for EndPoint

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

相等比较

let e: EndPoint = String::from("qingdao").try_into().unwrap();
assert!(e == "cn-qingdao");

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 PartialEq<EndPoint> for &str

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

相等比较

let e: EndPoint = String::from("qingdao").try_into().unwrap();
assert!("cn-qingdao" == e);

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 PartialEq<Url> for EndPoint

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

相等比较

use reqwest::Url;
let endpoint = EndPoint::new("shanghai").unwrap();
assert!(endpoint == Url::parse("https://oss-cn-shanghai.aliyuncs.com").unwrap());

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 PartialEq for EndPoint

fn eq(&self, other: &EndPoint) -> 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<'a> TryFrom<&'a str> for EndPoint

fn try_from(url: &'a str) -> Result<Self, Self::Error>

字符串字面量转 endpoint

举例

let e: EndPoint = "qingdao".try_into().unwrap();
assert_eq!(e, EndPoint::QINGDAO);

type Error = InvalidEndPoint

The type returned in the event of a conversion error.

impl TryFrom<String> for EndPoint

fn try_from(url: String) -> Result<Self, Self::Error>

字符串转 endpoint

举例

let e: EndPoint = String::from("qingdao").try_into().unwrap();
assert_eq!(e, EndPoint::QINGDAO);

type Error = InvalidEndPoint

The type returned in the event of a conversion error.

impl TryFrom<Url> for EndPoint

type Error = InvalidEndPoint

The type returned in the event of a conversion error.

fn try_from(url: Url) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for EndPoint

impl StructuralPartialEq for EndPoint