1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

use crate::oss::Client;

use self::builders::DescribeRegionsBuilder;

pub mod builders {
    use crate::oss::{
        self,
        api::{self, ApiResponseFrom},
        entities::region::RegionInfoList,
    };

    pub struct DescribeRegionsBuilder<'a> {
        client: &'a oss::Client<'a>,
        region: Option<&'a str>,
    }

    impl<'a> DescribeRegionsBuilder<'a> {
        pub(crate) fn new(client: &'a oss::Client) -> Self {
            Self {
                client,
                region: None,
            }
        }

        pub fn with_region(&mut self, value: &'a str) -> &Self {
            self.region = Some(value);
            self
        }

        pub async fn execute(&self) -> api::ApiResult<RegionInfoList> {
            let mut url = format!("{}/?regions", self.client.root_url());

            if let Some(region) = self.region {
                url = format!("{}={}", url, region);
            }

            let resp = self.client.request.task().with_url(&url).execute().await?;

            Ok(ApiResponseFrom(resp).to_type().await)
        }
    }
}

#[allow(non_snake_case)]
/// 关于Service操作
impl<'a> Client<'a> {
    /// 调用DescribeRegions接口查询所有支持地域或者指定地域对应的Endpoint信息,
    /// 包括外网Endpoint、内网Endpoint和传输加速Endpoint。
    ///
    /// - [official docs](https://help.aliyun.com/zh/oss/developer-reference/describeregions)
    /// - [xtoss example](https://github.com/isme-sun/xt_oss/blob/main/examples/api_describe_regions.rs)
    pub fn DescribeRegions(&self) -> DescribeRegionsBuilder {
        DescribeRegionsBuilder::new(self)
    }
}