pub struct Region { /* private fields */ }
Expand description

七牛存储区域

提供七牛不同服务的终端地址列表

use qiniu_http_client::Region;

let region = Region::builder("z0")
    .add_uc_preferred_endpoint("uc.qbox.me".parse()?)
    .add_up_preferred_endpoint("upload.qiniup.com".parse()?)
    .add_up_preferred_endpoint("up.qiniup.com".parse()?)
    .add_up_alternative_endpoint("up.qbox.me".parse()?)
    .add_rs_preferred_endpoint("rs.qbox.me".parse()?)
    .add_rsf_preferred_endpoint("rsf.qbox.me".parse()?)
    .add_api_preferred_endpoint("api.qiniu.com".parse()?)
    .build();

Implementations§

source§

impl Region

source

pub fn region_id(&self) -> &str

获取区域 ID

source

pub fn s3_region_id(&self) -> &str

获取 S3 区域 ID

source

pub fn up_preferred_endpoints(&self) -> &[Endpoint]

获取上传服务主要终端列表

up().preferred() 等效

source

pub fn up_alternative_endpoints(&self) -> &[Endpoint]

获取上传服务备选终端列表

up().alternative() 等效

source

pub fn io_preferred_endpoints(&self) -> &[Endpoint]

获取下载服务主要终端列表

io().preferred() 等效

source

pub fn io_alternative_endpoints(&self) -> &[Endpoint]

获取下载服务备选终端列表

io().alternative() 等效

source

pub fn uc_preferred_endpoints(&self) -> &[Endpoint]

获取存储空间管理服务主要终端列表

uc().preferred() 等效

source

pub fn uc_alternative_endpoints(&self) -> &[Endpoint]

获取存储空间管理服务备选终端列表

uc().alternative() 等效

source

pub fn rs_preferred_endpoints(&self) -> &[Endpoint]

获取元数据管理服务主要终端列表

rs().preferred() 等效

source

pub fn rs_alternative_endpoints(&self) -> &[Endpoint]

获取元数据管理服务备选终端列表

rs().alternative() 等效

source

pub fn rsf_preferred_endpoints(&self) -> &[Endpoint]

获取元数据列举服务主要终端列表

rsf().preferred() 等效

source

pub fn rsf_alternative_endpoints(&self) -> &[Endpoint]

获取元数据列举服务备选终端列表

rsf().alternative() 等效

source

pub fn api_preferred_endpoints(&self) -> &[Endpoint]

获取 API 入口服务主要终端列表

api().preferred() 等效

source

pub fn api_alternative_endpoints(&self) -> &[Endpoint]

获取 API 入口服务备选终端列表

api().alternative() 等效

source

pub fn s3_preferred_endpoints(&self) -> &[Endpoint]

获取 S3 入口服务主要终端列表

s3().preferred() 等效

source

pub fn s3_alternative_endpoints(&self) -> &[Endpoint]

获取 S3 入口服务备选终端列表

s3().alternative() 等效

source

pub fn up(&self) -> &Endpoints

获取上传服务终端地址列表

source

pub fn io(&self) -> &Endpoints

获取下载服务终端地址列表

source

pub fn uc(&self) -> &Endpoints

获取存储空间管理服务终端地址列表

source

pub fn rs(&self) -> &Endpoints

获取元数据管理服务终端地址列表

source

pub fn rsf(&self) -> &Endpoints

获取元数据列举服务终端地址列表

source

pub fn api(&self) -> &Endpoints

获取 API 入口服务终端地址列表

source

pub fn s3(&self) -> &Endpoints

获取 S3 入口服务终端地址列表

source

pub fn builder(region_id: impl Into<String>) -> RegionBuilder

创建区域构建器

Trait Implementations§

source§

impl Clone for Region

source§

fn clone(&self) -> Region

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Region

source§

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

Formats the value using the given formatter. Read more
source§

impl<'de> Deserialize<'de> for Region

source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
source§

impl Extend<Region> for GotRegions

source§

fn extend<T: IntoIterator<Item = Region>>(&mut self, iter: T)

Extends a collection with the contents of an iterator. Read more
source§

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)
Extends a collection with exactly one element.
source§

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)
Reserves capacity in a collection for the given number of additional elements. Read more
source§

impl Extend<Region> for StaticRegionsProvider

source§

fn extend<T: IntoIterator<Item = Region>>(&mut self, iter: T)

Extends a collection with the contents of an iterator. Read more
source§

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)
Extends a collection with exactly one element.
source§

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)
Reserves capacity in a collection for the given number of additional elements. Read more
source§

impl From<GotRegion> for Region

source§

fn from(result: GotRegion) -> Self

Converts to this type from the input type.
source§

impl From<Region> for GotRegion

source§

fn from(region: Region) -> Self

Converts to this type from the input type.
source§

impl From<Region> for StaticRegionsProvider

source§

fn from(region: Region) -> Self

Converts to this type from the input type.
source§

impl FromIterator<Region> for GotRegions

source§

fn from_iter<T: IntoIterator<Item = Region>>(iter: T) -> Self

Creates a value from an iterator. Read more
source§

impl FromIterator<Region> for StaticRegionsProvider

source§

fn from_iter<T: IntoIterator<Item = Region>>(iter: T) -> Self

Creates a value from an iterator. Read more
source§

impl PartialEq<Region> for Region

source§

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

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl RegionsProvider for Region

source§

fn get(&self, _opts: GetOptions) -> ApiResult<GotRegion>

返回七牛区域信息 Read more
source§

fn get_all(&self, opts: GetOptions) -> ApiResult<GotRegions>

返回多个七牛区域信息 Read more
source§

fn async_get(&self, opts: GetOptions) -> BoxFuture<'_, ApiResult<GotRegion>>

Available on crate feature async only.
异步返回七牛区域信息
source§

fn async_get_all( &self, opts: GetOptions ) -> BoxFuture<'_, ApiResult<GotRegions>>

Available on crate feature async only.
异步返回多个七牛区域信息
source§

impl Serialize for Region

source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
source§

impl Eq for Region

source§

impl StructuralEq for Region

source§

impl StructuralPartialEq for Region

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Conv for T

source§

fn conv<T>(self) -> Twhere Self: Into<T>,

Converts self into T using Into<T>. Read more
source§

impl<T> DynClone for Twhere T: Clone,

source§

fn __clone_box(&self, _: Private) -> *mut ()

source§

impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Pipe for Twhere T: ?Sized,

source§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
source§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
source§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
source§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> Rwhere Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
source§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R ) -> Rwhere Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
source§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> Rwhere Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
source§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> Rwhere Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
source§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> Rwhere Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
source§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R ) -> Rwhere Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
source§

impl<T> Tap for T

source§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
source§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
source§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Selfwhere Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
source§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
source§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Selfwhere Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
source§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
source§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Selfwhere Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
source§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
source§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
source§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
source§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Selfwhere Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
source§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
source§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Selfwhere Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
source§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
source§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Selfwhere Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
source§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> TryConv for T

source§

fn try_conv<T>(self) -> Result<T, Self::Error>where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> DeserializeOwned for Twhere T: for<'de> Deserialize<'de>,