查询域名排行统计数据。
参数名称 | 数据类型 | 是否必选 | 参数说明 |
|---|---|---|---|
Action | String | 是 | 接口名称。当前 API 的名称为 DescribeTopDomains。 |
Version | String | 是 | 接口版本。当前 API 的版本为 2021-04-01。 |
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
|---|---|---|---|---|
StartTime | String | 是 | 查询起始时间。 | 2021-01-01 00:00:00 |
EndTime | String | 是 | 查询结束时间。 | 2021-01-01 23:59:59 |
Sort | String | 是 | 指定排序指标，可指定值：
| traffic |
Domains | String[] | 否 | 指定查询域名列表。为空代表查询当前用户所有域名。 | ["example.com"] |
Limit | Integer | 否 | 域名获取数量限制，默认为20，取值支持1~100 。 | 50 |
ProjectName | String[] | 否 | 指定查询域名所属的项目，为空代表查询当前用户所有项目。 | ["test-project"] |
IspNameEn | String[] | 否 | 指定运营商，为空时表示查询所有运营商，支持取值：
| ["unicom"] |
AcceleratingRegion | String | 否 | 加速区域，不填表示查询所有区域，支持的参数如下所示
| CHN |
Area | String | 否 | 客户端所在区域，不填表示查询所有区域，支持参数：
| China |
Region | String[] | 否 | 指定区域，为空时表示查询所有区域。当 Area 为 China 或 Global 时，Region 支持的区域详见下方表格。 | ["HA","HB"] |
Protocol | String[] | 否 | 指定客户端请求应用层和传输层协议查询，为空时表示查询所有协议，支持参数：
| ["HTTP","HTTPS"] |
Type | String | 否 | 指定访问类型，不填时表示查询所有类型（相当于
| all |
IPVersion | String | 否 | 指定ip类型查询，不填时表示查询所有类型，支持参数：
| ipv4 |
| Area 取值 | 对应 Region 的取值范围 |
|---|---|
| China | ["BJ", "AH", "CQ", "FJ", "GD", "GS", "GX", "GZ", "HA", "HB", "HE", "HI", "HK", "HL", "HN", "JL", "JS", "JX", "LN", "MO", "NM", "NX", "QH", "SC", "SD", "SH", "SN", "SX", "TJ", "TW", "XJ", "XZ", "YN", "ZJ", "OTHERS"] |
| Global | ["CHN", "CHE", "AZE", "PNG", "PSE", "FSM", "LVA", "KHM", "SPM", "MYS", "COG", "VNM", "GRD", "HND", "GUF", "WLF", "COK", "BFA", "LAO", "IOT", "SVK", "GUM", "MLI", "RWA", "SGS", "IRN", "BLR", "KEN", "SMR", "BVT", "MSR", "DOM", "GIN", "IMN", "BLZ", "NRU", "NFK", "TZA", "BHR", "LBY", "YEM", "ARE", "SXM", "CPV", "MKD", "HMD", "ZWE", "ESP", "ATG", "BGD", "TKM", "MYT", "IND", "GRC", "SAU", "PHL", "GHA", "ISR", "VGB", "JAM", "TON", "DNK", "TCA", "LBR", "NLD", "PAN", "VCT", "COM", "PYF", "SWE", "CRI", "GTM", "KNA", "TUV", "PAK", "TJK", "DZA", "FIN", "MHL", "SLV", "FJI", "PER", "WSM", "CAF", "ERI", "LSO", "GGY", "MAR", "CYP", "ISL", "GNB", "NOR", "IRQ", "VUT", "AND", "CXR", "JOR", "MEX", "MCO", "NER", "JPN", "FRA", "EST", "VEN", "UMI", "AUS", "PRT", "GIB", "LIE", "ALB", "KOR", "HRV", "MNE", "TUN", "QAT", "SGP", "COL", "CUB", "EGY", "ARG", "CHL", "LCA", "ZAF", "CCK", "NPL", "MTQ", "ATF", "THA", "SRB", "ETH", "SJM", "BDI", "PRK", "GNQ", "BMU", "UKR", "OMN", "SDN", "ZMB", "DEU", "MDG", "AIA", "GUY", "NIC", "GRL", "MMR", "LKA", "BEL", "PRY", "PRI", "MLT", "MNP", "IRL", "ABW", "CYM", "TCD", "CIV", "BRB", "ALA", "BGR", "HTI", "NIU", "COD", "DJI", "TGO", "ASM", "BIH", "KWT", "MWI", "MNG", "SYR", "KAZ", "BEN", "SHN", "UGA", "KIR", "SLE", "AFG", "UZB", "SEN", "REU", "TUR", "URY", "TTO", "NAM", "ITA", "BOL", "PCN", "BWA", "MDV", "VAT", "SSD", "CZE", "MUS", "SOM", "XKS", "SUR", "GBR", "BRA", "JEY", "ECU", "FLK", "NCL", "AGO", "MOZ", "POL", "PLW", "IDN", "SLB", "GMB", "LBN", "MAF", "BHS", "USA", "ARM", "GLP", "BTN", "CUW", "ESH", "ROU", "GEO", "NGA", "LTU", "VIR", "SYC", "ATA", "RUS", "TKL", "GAB", "CAN", "BRN", "STP", "NZL", "CMR", "SWZ", "TLS", "SVN", "LUX", "MDA", "HUN", "FRO", "MRT", "BLM", "AUT", "KGZ", "OTHERS"] |
| 为空 | 全部区域 |
参数名称 | 数据类型 | 参数说明 | 示例 |
|---|---|---|---|
DomainCount | Integer | 查询域名中有效域名的数量。 | 10 |
StartTime | String | 查询起始时间。 | 2021-01-01 00:00:00 |
EndTime | String | 查询结束时间。 | 2021-01-01 23:59:59 |
TopDomains | Object[] | 域名排名列表。 |
POST https://open.volcengineapi.com?Action=DescribeTopDomains&Version=2021-04-01 { "StartTime": "2019-12-13 00:00:00", "EndTime": "2019-12-13 00:00:00", "Sort": "request" }
{ "ResponseMetadata": { "RequestId": "2021092620401201022508421706B81F53", "Action": "DescribeTopDomains", "Version": "2021-04-01", "Service": "dcdn", "Region": "cn-south-1" }, "Result": { "TopDomains": [ { "DomainName": "www.a.com", "Rank": 1, "Request": 3, "Traffic": 3, "Bandwidth": 3, "QPS": 3 }, { "DomainName": "www.b.com", "Rank": 2, "Request": 3, "Traffic": 3, "Bandwidth": 3, "QPS": 3 } ] } }