# 查询区域消耗统计
支持查询90天内的数据。
时间跨度最大不超过31天。
最多同时指定100个域名。
起始时间和结束时间需同时指定，为毫秒级时间戳，且必须为时间粒度的整时刻点。当时间跨度\<=1天，时间粒度为5分钟；1天\<时间跨度\<=7天，时间粒度为1小时；时间跨度\>7天，时间粒度为4小时。如时间跨度\<=1天时，此时时间粒度为5分钟，传入时间为2020-07-01 08:05:00、2020-07-01 08:10:00。
如果起始时间、结束时间不满足对应时间粒度的整时刻点，返回数据可能与预期不一致。
#### 功能介绍
用于查询指定域名在指定区域、时间范围内的相关指标统计详情。
#### URI
GET /v1.0/cdn/statistics/region-detail-summary
#### 请求消息
**请求参数**
请求参数如[表1]所示。
 表1请求参数 
| 名称                    | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| start_time            | 否    | Long   | 查询起始时间戳（单位：毫秒）。                                                                                                                                                                                                                                                                                                                                                                                                        |
| end_time              | 否    | Long   | 查询结束时间戳（单位：毫秒）。                                                                                                                                                                                                                                                                                                                                                                                                        |
| domain_name           | 是    | String | 域名列表，多个域名以逗号（半角）分隔，如：www.test1.com,www.test2.com ，ALL表示查询名下全部域名。                                                                                                                                                                                                                                                                                                                                                       |
| stat_type             | 是    | String | 参数类型支持：flux(流量)，bw(带宽),req_num(请求总数)                                                                                                                                                                                                                                                                                                                                                                                   |
| region                | 否    | String | 区域列表，包括：中国34个省级行政区域（包含中国大陆省份、直辖市及港澳台）、中国以外及其他，多个区域以逗号分隔，如：beijing,neimenggu,........ 说明： - 传参时区域名称，如"北京、上海、港澳台"等均需用汉语拼音（beijing、shanghai、gangaotai），"中国以外"请用"haiwai"传参。  - "山西、陕西"传参时分别用："shanxi、shaanxi"。   ALL或者不传表示查询全部区域。 |
| enterprise_project_id | 否    | String | 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。                                                                                                                                                                                                                                                                                                                                                        |
   
**请求示例**
请求路径示例
```
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/region-detail-summary?start_time=1511366400000&end_time=1511452799640&domain_name=ALL&stat_type=req_num&region=beijing,neimenggu&enterprise_project_id=0
```
#### 响应消息
**响应参数**
响应参数如[表2]所示。
 表2响应参数 
| 名称          | 参数类型             | 描述                                                 |
|:---|:---|:---|
| region_data | Array of objects | 区域数据列表。详细说明见[表3]。 |
   
**region_data参数说明**
region_data参数说明如[表3]所示。
 表3region_data参数说明 
| 名称     | 参数类型    | 描述                            |
|:---|:---|:---|
| region | String  | 区域。                           |
| value  | Integer | 对应查询类型的值。（流量单位：Byte，带宽单位：bps） |
   
**响应示例**
```
{
   "region_data":
   [
      {
        "region": "beijing",
        "value": 586
      },
      {
        "region": "neimenggu",
        "value": 862
      }
   ]
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-cdn/cdn_02_0070.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。