最近更新时间:2024.04.18 16:04:09
首次发布时间:2024.04.16 14:36:30
API 描述:基于加速域名向源站发送的请求、指定的统计时间段和时间粒度,对每个指定加速域名统计指定指标的细分数据。您最多能查询过去 92 天的数据。
数据稳定性:受边缘节点网络波动的影响,监控数据的统计可能会发生变化。大多数情况下,监控数据的统计会在数据产生后的 12 小时内稳定下来。
节流限制:您每秒最多可以提交 20 个 API 请求。
参数名称 | 数据类型 | 是否必选 | 参数说明 |
---|---|---|---|
Action | String | 是 | 接口名称。当前 API 的名称为 DescribeOriginData 。 |
Version | String | 是 | 接口版本。当前 API 的版本为 2021-03-01 。 |
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
Metric | String | 是 | 表示一个统计指标。该参数有以下取值:
| traffic |
StartTime | Long | 是 | 表示统计时间段的开始时间,格式是 Unix 时间戳,精度是秒。 StartTime 必须早于或者等于 EndTime 。同时,StartTime 与 EndTime 所表示的统计时间段不能超过 31 天。 | 1710259200 |
EndTime | Long | 是 | 表示统计时间段的结束时间,格式是 Unix 时间戳,精度是秒。 | 1710836303 |
Interval | String | 否 | 表示指标数据的统计时间粒度。该 API 会基于 关于该参数对统计结果影响的详细描述,参考 统计时间段说明。 该参数有以下取值:
您可以指定的时间粒度受
5min 。如果默认值不匹配时间范围,API 请求会失败。 | hour |
Project | String | 否 | 表示一个项目,以获取该项目下的所有加速域名,用于对回源请求进行过滤。 如果不指定Project ,表示不使用该参数对请求进行过滤。 | my_project |
Domain | String | 否 | 表示一个或多个加速域名,用于对回源请求进行过滤。您最多可以指定 50 个加速域名。多个域名之间使用逗号(,)分隔。如果您不指定 如果您指定了 说明 当子用户调用该 API 时,请留意以下说明:
| www.example.com,www.test.com,img.example.com |
参数名称 | 数据类型 | 参数说明 | 示例 |
---|---|---|---|
MetricDataList | Object[] | 表示该 API 返回的指标数据。 |
POST https://cdn.volcengineapi.com/?Action=DescribeOriginData&Version=2021-03-01 { "Domain": "www.example.com,www.test.com,img.example.com", "StartTime": 1710259200, "EndTime": 1710835599, "Interval": "day", "Metric": "bandwidth", "Project": "my_project" }
{ "ResponseMetadata": { "RequestId": "2024031921134182B850C488CDCFC14D68", "Action": "DescribeOriginData", "Version": "2021-03-01", "Service": "CDN", "Region": "cn-north-1" }, "Result": { "MetricDataList": [ { "Metric": "bandwidth", "Values": [ { "TimeStamp": 1710259200, "Value": 47235 }, { "TimeStamp": 1710345600, "Value": 79391 }, { "TimeStamp": 1710432000, "Value": 47344 }, { "TimeStamp": 1710518400, "Value": 46993 }, { "TimeStamp": 1710604800, "Value": 491846 }, { "TimeStamp": 1710691200, "Value": 77291 }, { "TimeStamp": 1710777600, "Value": 48624 } ] } ] } }