You need to enable JavaScript to run this app.
导航
内容分发网络
  • 文档首页
    • /内容分发网络/API 参考/数据统计接口（旧版）/DescribeCdnDataDetail - 获取单个域名的省份和 ISP 的细分数据
DescribeCdnDataDetail - 获取单个域名的省份和 ISP 的细分数据
最近更新时间：2025.12.01 14:38:50首次发布时间：2021.11.16 16:59:41
复制全文
我的收藏
有用
有用
无用
无用

说明

在新版数据统计接口中，该 API 没有更新，可继续使用。

基于指定的时间段和时间粒度，对一个域名统计访问请求指标的数据。指标数据是按统计时间段统计的，细分到中国的省份行政区和 ISP。

数据稳定性：受边缘节点网络波动的影响，监控数据的统计可能会发生变化。大多数情况下，监控数据的统计会在数据产生后的 12 小时内稳定下来。

说明

如果您是刚开始使用数据统计的 API，请务必先阅读以下文档，这将有助于您理解该 API 文档。

使用限制

节流限制：您每秒最多可以发送 20 个 API 请求。

时间限制：系统保留最近 92 天的访问数据。您不能查询 92 天以前的访问数据。

数据延迟：访问数据延迟约为 5 分钟。

请求说明

  • 请求方式：POST
  • 请求地址：https://cdn.volcengineapi.com/?Action=DescribeCdnDataDetail&Version=2021-03-01

请求参数

Query

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

Body

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

指定一个开始时间。时间格式是 Unix 时间戳，精度是秒。StartTime 必须早于或者等于 EndTime。同时，StartTime 与 EndTime 所指定的时间段不能超过 7 天。

您必须同时指定 StartTime 和 EndTime，或者都不指定。如果您不指定这 2 个参数，默认统计最近 1 小时的数据。



StartTime、EndTime、Interval 这三个参数决定了该 API 基于哪些时间段的数据做聚合。参考 统计时间段说明。
1641844915
EndTime
Long
是
指定一个结束时间。时间格式是 Unix 时间戳，精度是秒。
1641845373
Metric
String
是

指定一个指标。该参数的可用值如下：

  • flux：表示访问数据的流量。单位是 Byte。
  • bandwidth：表示访问数据的带宽。单位是bps。
  • pv：表示访问的请求数。单位是个。
  • qps：表示访问请求的 QPS 峰值。单位是次/秒。
  • status_2xx：表示数字 2 开头的所有状态码的数量，以及数字 2 开头且数量不为 0 的每个状态码的数量。
  • status_3xx：表示数字 3 开头的所有状态码的数量，以及数字 3 开头且数量不为 0 的每个状态码的数量。
  • status_4xx：表示数字 4 开头的所有状态码的数量，以及数字 4 开头且数量不为 0 的每个状态码的数量。
  • status_5xx：表示数字 5 开头的所有状态码的数量，以及数字 5 开头且数量不为 0 的每个状态码的数量。
flux
Domain
String
是
指定一个域名进行统计。
www.example.com
Interval
String
否

指定一个时间粒度。基于这个粒度，对访问数据进行细分统计。

该参数的可用值如下：

  • 1min：表示以 1 分钟为时间粒度。
  • 5min：表示以 5 分钟为时间粒度。
  • hour：表示以 1 小时为时间粒度。
  • day：表示以 1 天为时间粒度。

您可以指定的时间粒度与StartTime 和 EndTime 指定的时间范围的关系如下：

  • 如果时间范围 <= 10 分钟，您可以指定的时间粒度有 1min、5min。
  • 如果时间范围 > 10 分钟并且 <= 1 小时，您可以指定的时间粒度有 5min。
  • 如果时间范围 > 1 小时并且 <= 12 小时，您可以指定的时间粒度有 hour。
  • 如果时间范围 > 12 小时并且 <= 7 天，您可以指定的时间粒度有 day。
如果不指定该参数，该参数使用默认值 5min。如果默认值不匹配时间范围，API 请求会失败。
1min
Protocol
String
否

指定请求的一个应用层协议。该参数的可用值如下：

  • http：表示 HTTP 协议。
  • https：表示 HTTPS 协议。
  • quic：表示 QUIC 协议。
如果不指定该参数，表示包含所有支持的应用层协议。
http
IpVersion
String
否

指定请求的一个网络层协议。该参数的可用值如下：

  • ipv4：表示 IPv4 访客的请求。
  • ipv6：表示 IPv6 访客的请求。
如果不指定该参数，表示包含所有支持的网络层协议。
ipv6

返回参数

参数名称
数据类型
参数说明
示例
Name
String
表示指定的域名。
www.example.com
DataDetails
Object[]
省份运营商数据详情

请求示例

POST https://cdn.volcengineapi.com/?Action=DescribeCdnDataDetail&Version=2021-03-01
{
    "StartTime": 1672831000,
    "EndTime": 1672831410,
    "Metric": "flux",
    "Domain": "www.example.com",
    "Interval": "1min"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202301042002223CADFB9D97DEC93844E2",
        "Action": "DescribeCdnDataDetail",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-1"
    },
    "Result": {
        "DataDetails": [
            {
                "Isp": "CT",
                "Metrics": [
                    {
                        "Metric": "flux",
                        "Values": [
                            {
                                "Timestamp": 1672830960,
                                "Value": 49678.2
                            },
                            {
                                "Timestamp": 1672831020,
                                "Value": 98247.6
                            }
                        ]
                    }
                ],
                "Region": "SN"
            }
        ],
        "Name": "www.example.com"
    }
}

错误码

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