查询热点 URL--多云CDN-火山引擎

文档中心

立即注册

导航

查询热点 URL

最近更新时间：2025.08.27 17:38:47首次发布时间：2025.08.27 17:38:47

调用本接口查询指定 CDN 加速域名的被请求 URL 排行。

说明

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

使用说明

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

接口说明

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

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

使用限制

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

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
StartTime	Long	是	指定一个开始时间，以查询从该开始时间（含）到 `EndTime` 所指定的结束时间（不含）范围内的数据。使用时间戳格式，单位为秒。说明不同云服务商平台允许查询的数据时间范围不同。若您设置的开始时间不符合云服务商平台的要求（如超出最长可查询时间），那么查询会失败。	`1755619200`
EndTime	Long	是	指定一个结束时间，以查询从 `StartTime` 所指定的开始时间（含）到该结束时间（不含）范围内的数据。使用时间戳格式，单位为秒。说明不同云服务商平台允许查询的数据时间跨度不同。若您设置的时间范围不符合云服务商平台的要求（如超出允许的时间跨度），那么查询会失败。	`1755964800`
SortBy	String	否	指定返回数据的排序方式。该参数有以下取值： `request`（默认）：按请求次数从大到小排序 `flux`：按流量从大到小排序 `status_2xx`：按 2XX 状态码数量从大到小排序 `status_3xx`：按 3XX 状态码数量从大到小排序 `status_4xx`：按 4XX 状态码数量从大到小排序 `status_5xx`：按 5XX 状态码数量从大到小排序	`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`

返回参数

参数名称	数据类型	参数说明	示例
Urls	Object[]	查询得到的数据明细，包含 URL 及其相关数据。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "DescribeCdnTopUrl",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "Urls": [
            {
                "Url": "http://example.com/resource1",
                "Flux": 467832647,
                "Request": 3456
            }
        ]
    }
}

错误码

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