Struct Region

pub struct Region { /* private fields */ }

七牛存储区域

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

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

impl Region

pub fn region_id(&self) -> &str

获取区域 ID

pub fn s3_region_id(&self) -> &str

获取 S3 区域 ID

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

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

与 up().preferred() 等效

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

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

与 up().alternative() 等效

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

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

与 io().preferred() 等效

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

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

与 io().alternative() 等效

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

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

与 uc().preferred() 等效

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

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

与 uc().alternative() 等效

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

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

与 rs().preferred() 等效

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

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

与 rs().alternative() 等效

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

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

与 rsf().preferred() 等效

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

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

与 rsf().alternative() 等效

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

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

与 api().preferred() 等效

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

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

与 api().alternative() 等效

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

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

与 s3().preferred() 等效

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

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

与 s3().alternative() 等效

pub fn up(&self) -> &Endpoints

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

pub fn io(&self) -> &Endpoints

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

pub fn uc(&self) -> &Endpoints

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

pub fn rs(&self) -> &Endpoints

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

pub fn rsf(&self) -> &Endpoints

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

pub fn api(&self) -> &Endpoints

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

pub fn s3(&self) -> &Endpoints

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

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

创建区域构建器

Trait Implementations

impl Clone for Region

fn clone(&self) -> Region

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Region

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Extend<Region> for GotRegions

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

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

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.

impl Extend<Region> for StaticRegionsProvider

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

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

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.

impl From<GotRegion> for Region

fn from(result: GotRegion) -> Self

Converts to this type from the input type.

impl From<Region> for GotRegion

fn from(region: Region) -> Self

Converts to this type from the input type.

impl From<Region> for StaticRegionsProvider

fn from(region: Region) -> Self

Converts to this type from the input type.

impl FromIterator<Region> for GotRegions

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

Creates a value from an iterator.

impl FromIterator<Region> for StaticRegionsProvider

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

Creates a value from an iterator.

impl PartialEq for Region

fn eq(&self, other: &Region) -> 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 RegionsProvider for Region

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

返回七牛区域信息

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

返回多个七牛区域信息

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

Available on crate feature async only.

异步返回七牛区域信息

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

Available on crate feature async only.

异步返回多个七牛区域信息

impl Serialize for Region

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Region

impl StructuralPartialEq for Region