查询域名排行统计数据 DescribeTopDomains--全站加速-火山引擎

文档中心

全站加速

数据监控接口

查询域名排行统计数据 DescribeTopDomains

查询域名排行统计数据。

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
StartTime	String	是	查询起始时间。	`2021-01-01 00:00:00`
EndTime	String	是	查询结束时间。	`2021-01-01 23:59:59`
Sort	String	是	指定排序指标，可指定值： `traffic`：流量。 `bandwidth`：峰值带宽。 `request`: 请求数。 `QPS`: 峰值 QPS 。 `2xx`: 2xx状态码数量。 `3xx`: 3xx状态码数量。 `4xx`:4xx状态码数量。 `5xx`: 5xx状态码数量。	`traffic`
Domains	String[]	否	指定查询域名列表。为空代表查询当前用户所有域名。	`["example.com"]`
Limit	Integer	否	域名获取数量限制，默认为20，取值支持1~100 。	`50`
ProjectName	String[]	否	指定查询域名所属的项目，为空代表查询当前用户所有项目。	`["test-project"]`
IspNameEn	String[]	否	指定运营商，为空时表示查询所有运营商，支持取值： `unicom`：联通 `telecom`：电信 `mobile`：移动 `guangdian`：广电 `edu`：教育网 `tietong`：铁通 `pengboshi`：鹏博士 `other`：其他运营商	`["unicom"]`
ServiceType	String	否	指定加速域名关联的加速场景，支持取值： `ai`：AI 加速 `upload`：上传加速 `page`：页面加速 `api`：API 加速 `other`：其他	`api`
AcceleratingRegion	String	否	加速区域，不填表示查询所有区域，支持的参数如下所示 `CHN`：中国内地 `EU`（仅对开通此功能的客户可见）：欧洲 `NA`（仅对开通此功能的客户可见）：北美 `SA`（仅对开通此功能的客户可见）：南美 `ME`（仅对开通此功能的客户可见）：中东 `AP1`（仅对开通此功能的客户可见）：亚太1 `AP2`（仅对开通此功能的客户可见）：亚太2 `AP3`（仅对开通此功能的客户可见）：亚太3	`CHN`
AcceleratingScope	String	否	指定加速区域范围，为空时表示查询全球范围，支持取值： `mainland`：中国内地。 `overseas`：海外（中国内地以外区域）	`mainland`
Area	String	否	客户端所在区域，不填表示查询所有区域，支持参数： `China`：中国大陆； `Global`：全球。	`China`
Region	String[]	否	指定区域，为空时表示查询所有区域。当 `Area` 为 `China` 或 `Global` 时，`Region` 支持的区域详见下方表格。	`["HA","HB"]`
Protocol	String[]	否	指定客户端请求应用层和传输层协议查询，为空时表示查询所有协议，支持参数： `ALL`：全部协议； `HTTP`：HTTP协议； `HTTPS`：HTTPS协议； `QUIC`：QUIC协议； `WS`：WebSocket协议。	`["HTTP","HTTPS"]`
Type	String	否	指定访问类型，不填时表示查询所有类型（相当于`all`），支持参数： `all`：所有类型。 `dynamic`：指定查询动态对应指标。 `static`：指定查询静态对应指标。	`all`
IPVersion	String	否	指定ip类型查询，不填时表示查询所有类型，支持参数： `all`：所有类型； `ipv4`：IPv4 类型； `ipv6`：IPv6 类型。	`ipv4`
Metrics	String[]	否	指定返回的监控指标，支持取值： `all`：全部指标。 `traffic`：流量，单位为 byte。 `bandwidth`：峰值带宽，单位为 bps。 `request`：请求数。 `QPS`：峰值QPS。 `2xx`：返回 2xx 状态码的请求数。返回结果会提供 2xx 状态码总请求数以及单个 2xx 状态码的总请求数。 `3xx`：返回 3xx 状态码的请求数。返回结果会提供 3xx 状态码总请求数以及单个 3xx 状态码的总请求数。 `4xx`：返回 4xx 状态码的请求数。返回结果会提供 4xx 状态码总请求数以及单个 4xx 状态码的总请求数。 `5xx`：返回 5xx 状态码的请求数。返回结果会提供 5xx 状态码总请求数以及单个 5xx 状态码的总请求数。	`["bandwidth","traffic","5xx"]`
ResourceTagFilter	Object	否	指定加速域名关联的资源标签。可以调用 ListResourceTags 查看资源标签列表。

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": "2025-04-05 00:00:00",
    "EndTime": "2025-04-10 00:00:00",
    "Sort": "traffic",
    "AcceleratingScope": "mainland"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202506041009340DE58509E3694AB488D8",
        "Action": "DescribeTopDomains",
        "Version": "2021-04-01",
        "Service": "DCDN",
        "Region": "cn-north-01"
    },
    "Result": {
        "DomainCount": 78,
        "EndTime": "2025-04-10 00:00:00",
        "StartTime": "2025-04-05 00:00:00",
        "TopDomains": [
            {
                "Bandwidth": 6864,
                "DomainName": "www.example.com",
                "QPS": 0.33333333333333337,
                "Rank": 1,
                "Request": 144000,
                "StatusCode1xx": 0,
                "StatusCode1xxRatio": 0,
                "StatusCode2xx": 144000,
                "StatusCode2xxRatio": 1,
                "StatusCode3xx": 0,
                "StatusCode3xxRatio": 0,
                "StatusCode4xx": 0,
                "StatusCode4xxRatio": 0,
                "StatusCode5xx": 0,
                "StatusCode5xxRatio": 0,
                "Traffic": 370097811
            },
            {
                "Bandwidth": 11458.88,
                "DomainName": "dcdn.example.com",
                "QPS": 0.4266666666666667,
                "Rank": 2,
                "Request": 680,
                "StatusCode1xx": 0,
                "StatusCode1xxRatio": 0,
                "StatusCode2xx": 0,
                "StatusCode2xxRatio": 0,
                "StatusCode3xx": 0,
                "StatusCode3xxRatio": 0,
                "StatusCode4xx": 0,
                "StatusCode4xxRatio": 0,
                "StatusCode5xx": 680,
                "StatusCode5xxRatio": 1,
                "Traffic": 1485401
            },
            {
                "Bandwidth": 7360.666666666667,
                "DomainName": "api.example.com",
                "QPS": 0.17666666666666667,
                "Rank": 3,
                "Request": 150,
                "StatusCode1xx": 0,
                "StatusCode1xxRatio": 0,
                "StatusCode2xx": 44,
                "StatusCode2xxRatio": 0.29333333333333333,
                "StatusCode3xx": 0,
                "StatusCode3xxRatio": 0,
                "StatusCode4xx": 106,
                "StatusCode4xxRatio": 0.7066666666666667,
                "StatusCode5xx": 0,
                "StatusCode5xxRatio": 0,
                "Traffic": 473262
            }
        ]
    }
}

最近更新时间：2026.05.25 16:53:18

这个页面对您有帮助吗？

有用

无用

全站加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

请求说明

请求参数

Query

Body

返回参数

请求示例

返回示例