You need to enable JavaScript to run this app.
导航
多云CDN
  • 文档首页
    • /多云CDN/API参考/统计分析接口/查询热点 IP
查询热点 IP
最近更新时间：2025.08.27 17:38:47首次发布时间：2025.08.27 17:38:47
复制全文
我的收藏
有用
有用
无用
无用

调用本接口查询指定 CDN 加速域名的访问者 IP 排行。

说明

多云CDN调用云服务商的相关接口获取热点 IP 数据。如果云服务商不支持热点 IP 数据查询，则无法查询相关数据。

使用说明

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制。

接口说明

本接口提供了以下两种指定加速域名的方式，您只能选择其中一种方式来指定要查询的加速域名：

  • 只设置请求参数 DomainId：
    DomainId 是多云CDN为每个同步到多云CDN的加速域名分配的唯一 ID。选择此方式时，不能设置 Domain、Vendor 和 SubProduct，否则请求会失败。
  • 同时设置请求参数 Domain、Vendor 和 SubProduct。
    由这 3 个参数值确定向哪个云服务商平台查询加速域名的数据。选择此方式时，这 3 个参数必须同时设置，否则请求会失败。

使用限制

  • 节流限制：您每秒最多可以提交 30 个 API 请求。
  • 数据查询限制：部分云服务商未提供热点 IP 数据查询功能，详情请参见数据查询限制。

请求说明

  • 请求方式：POST
  • 请求地址：https://mcdn.volcengine-api.com/?Action=DescribeCdnTopIp&Version=2022-03-01

请求参数

Query

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

Body

参数名称
数据类型
是否必选
参数说明
示例
StartTime
Long
是

指定一个开始时间，以查询从该开始时间（含）到 EndTime 所指定的结束时间（不含）范围内的数据。使用时间戳格式，单位为秒。

说明

不同云服务商平台允许查询的数据时间范围不同。若您设置的开始时间不符合云服务商平台的要求（如超出最长可查询时间），那么查询会失败。

1755619200
EndTime
Long
是

指定一个结束时间，以查询从 StartTime 所指定的开始时间（含）到该结束时间（不含）范围内的数据。使用时间戳格式，单位为秒。

说明

不同云服务商平台允许查询的数据时间跨度不同。若您设置的时间范围不符合云服务商平台的要求（如超出允许的时间跨度），那么查询会失败。

1755964800
SortBy
String
否

指定返回数据的排序方式。该参数有以下取值：

  • request（默认）：按请求次数从大到小排序
  • flux：按流量从大到小排序
request
Domain
String
否

指定要查询的加速域名。只支持设置一个域名。

说明

  • Domain 和 DomainId 不允许同时为空，否则查询请求会失败。
  • 如果您指定了 Domain，则必须同时指定 Vendor 和 SubProduct。
example.com
Vendor
String
否

指定一个云服务商，向该云服务商平台发起数据查询请求。

说明

如果您指定了 Domain，则必须同时指定 Vendor 和 SubProduct。

该参数有以下取值：

  • builtin：内置加速
  • aliyun：阿里云
  • tencent：腾讯云
  • ksyun：金山云
  • huawei：华为云
  • volcengine：火山引擎
  • wangsu：网宿科技
  • qiniu：七牛云
  • ucloud：UCloud
  • akamai：Akamai
  • baishan：白山云
  • aws：AWS
  • baidu：百度智能云
  • jingdong：京东云
  • gcp：Google Cloud
  • chinamobile：中国移动
  • ctcdn：天翼云CDN+
  • azure：Azure
  • cloudflare：Cloudflare
volcengine
DomainId
String
否

指定要查询的加速域名的 ID。

说明

  • 您可以调用 ListCdnDomains 接口查询所有加速域名的 ID。
  • 如果您指定了 DomainId，则不能指定 Domain、Vendor 和 SubProduct。
654a20acbd82bac3e2c6****
SubProduct
String
否

指定一个产品类型。

说明

如果您指定了 Domain，则必须同时指定 Vendor 和 SubProduct。

该参数有以下取值：

  • cdn（默认）：内容分发网络（CDN）
  • ucdn：UCloud UCDN
  • cloudfront：AWS CloudFront
  • amd：Akamai AMD
  • dsa：Akamai DSA
  • media_cdn：Google Cloud Media CDN
  • dcdn：全站加速（DCDN）
  • ecdn：腾讯云 ECDN
  • edgeone：腾讯云 EdgeOne
cdn

返回参数

参数名称
数据类型
参数说明
示例
Ips
Object[]
查询得到的数据明细列表，包含访问者 IP 及其相关数据。

请求示例

POST https://mcdn.volcengine-api.com/?Action=DescribeCdnTopIp&Version=2022-03-01
{
    "StartTime": 1755619200,
    "EndTime": 1755964800,
    "SortBy": "request",
    "Domain": "example.com",
    "Vendor": "volcengine",
    "SubProduct": "cdn"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "DescribeCdnTopIp",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "Ips": [
            {
                "Ip": "192.0.2.1",
                "Flux": 467832647,
                "Request": 3456
            }
        ]
    }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。