查询区域分布统计数据--全站加速-火山引擎

文档中心

立即注册

导航

查询区域分布统计数据

最近更新时间：2025.04.01 19:57:32首次发布时间：2021.12.27 17:16:07

查询域名的区域分布统计数据。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=DescribeDomainRegionData&Version=2021-04-01

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `DescribeDomainRegionData`。
Version	String	是	接口版本。当前 API 的版本为 `2021-04-01`。

Body

参数名称	数据类型	是否必选	参数说明	示例
StartTime	String	是	查询起始时间。	`2021-01-01 00:00:00`
EndTime	String	是	查询结束时间。结束时间必须大于起始时间。`StartTime`及`EndTime`定义的查询的时间段不能超过 31 天。	`2021-01-01 23:59:59`
Domain	String	是	指定查询加速域名。仅支持单个域名。	`www.bytedance.com`
ProjectName	String[]	否	指定查询域名所属的项目。为空代表查询当前用户所有项目。	`["Test"]`
Area	String	否	客户端所在区域。不填表示查询全球区域，支持取值： `China`：仅中国内地 `Global`：全球	`Global`

返回参数

参数名称	数据类型	参数说明	示例
DomainName	String	查询域名。	`www.bytedance.com`
StartTime	String	查询起始时间。	`2021-01-01 00:00:00`
EndTime	String	查询结束时间。	`2021-01-01 23:59:59`
Values	Object[]	具体区域分布统计数据。

请求示例

POST https://open.volcengineapi.com?Action=DescribeDomainRegionData&Version=2021-04-01
{
    "Domain": "",
    "StartTime": "2024-10-30 00:00:00",
    "EndTime": "2024-10-31 00:00:00",
    "Area": "Global",
    "ProjectName": []
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2024103117024504008005613348A2CF",
        "Action": "DescribeDomainRegionData",
        "Version": "2021-04-01",
        "Service": "dcdn",
        "Region": "cn-beijing"
    },
    "Result": {
        "DomainName": "",
        "StartTime": "2024-10-30 00:00:00",
        "EndTime": "2024-10-31 00:00:00",
        "Values": [
            {
                "Bandwidth": 12462.002666666669,
                "Traffic": 6280597.4,
                "TrafficProportion": 99.98926491270868,
                "Request": 2609,
                "RequestProportion": 99.96168582375479,
                "AvgResponseTime": 16019.821711387262,
                "Region": "中国",
                "RegionEname": "CHN"
            },
            {
                "Bandwidth": 17.981333333333335,
                "Traffic": 674.3000000000001,
                "TrafficProportion": 0.010735087291320323,
                "Request": 1,
                "RequestProportion": 0.03831417624521073,
                "AvgResponseTime": 48,
                "Region": "新加坡",
                "RegionEname": "SGP"
            }
        ]
    }
}