# 查询TOP域名
#### 功能介绍
- 查询TOP域名。
- 支持查询90天内的数据。
- 查询时间跨度不能超过1天。
- 起始时间和结束时间，左闭右开，必须同时指定。如查询2022-10-24 00:00:00 到 2022-10-25 00:00:00 的数据，表示取 \[2022-10-24 00:00:00, 2022-10-25 00:00:00)的统计数据。
- 起始时间、结束时间必须传整点毫秒级时间戳。
- 流量类指标单位统一为Byte（字节）、带宽类指标单位统一为bit/s（比特/秒）、请求数类和状态码类指标单位统一为次数。用于查询指定域名、指定统计指标的明细数据。
- 单租户调用频率：5次/s。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CDN&api=ShowTopDomainNames)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v1/cdn/statistics/top-domain-names
表1Query参数 
| 参数                    | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| start_time            | 是    | Long    | - 查询起始时间戳，时间戳应设置为整点时间戳，设置方式如下：  - interval为3600时，start_time设置为整小时时刻点，如：1631239200000(对应2021-09-10 10:00:00)  - interval为86400时，start_time设置为东8区零点时刻点，如：1631203200000(对应2021-09-10 00:00:00)     |
| end_time              | 是    | Long    | - 查询结束时间戳，时间戳应设置为整点时间戳，设置方式如下：  - interval为3600时，end_time设置为整小时时刻点，如：1631325600000(对应2021-09-11 10:00:00)  - interval为86400时，end_time设置为东8区零点时刻点，如：1631376000000(对应2021-09-12 00:00:00)   |
| stat_type             | 是    | String  | - 统计类型  - 目前只支持bw（带宽），flux（流量），req_num（请求总数）                                                                                                                                                                                                                              |
| service_area          | 否    | String  | 服务区域：mainland_china（默认）、outside_mainland_china，当查询回源类指标时该参数无效。                                                                                                                                                                                                                                                                                                                                                                                                         |
| limit                 | 否    | Integer | top域名查询数量,默认为20,最大为500，最小为0                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| enterprise_project_id | 否    | String  | 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。                                                                                                                                                                                                                                                                                                                                                                                                        |
   
#### 请求参数
无
#### 响应参数
**状态码： 200**
表2响应Body参数 
| 参数               | 参数类型                                  | 描述      |
|:---|:---|:---|
| top_domain_names | Array of Map\<String,Object\> objects | top域名信息 |
   
**状态码： default**
表3响应Body参数 
| 参数    | 参数类型                                                  | 描述              |
|:---|:---|:---|
| error | [ErrMsg] object | 用于返回具体的错误码和错误消息 |
   
 表4ErrMsg 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
```
GET  https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/top-domain-names？start_time=1667030400000&end_time=1667116800000&stat_type=bw&service_area=mainland_china&limit=100&enterprise_project_id=all
```
#### 响应示例
```
{
  "top_domain_names": [
    {
      "domain_name": "www.test1.com",
      "flux": 10000000
    },
    {
      "domain_name": "www.test2.com",
      "flux": 20000000
    },
    {
      "domain_name": "www.test3.com",
      "flux": 30000000
    }
  ]
}
```
#### 状态码
| 状态码     | 描述   |
|:---|:---|
| 200     | 正常响应 |
| default | 异常响应 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。