最近更新时间：2023.10.26 11:48:59
首次发布时间：2022.09.08 13:59:53
API名称：DescribeOriginStatisticsDetail。
API域名：open.volcengineapi.com。
API描述：查询访问回源资源用量细节 。
Action和Version需要放在请求 URL 后方参数中。
参数名称 | 是否必选 | 参数类型 | 参数说明 |
|---|---|---|---|
Action | 是 | String | API 名称，该参数的取值是 DescribeOriginStatisticsDetail 。 |
Version | 是 | String | API 版本，该参数的取值是 2021-04-01 。 |
参数名称 | 是否必选 | 参数类型 | 参数说明 | 示例 |
|---|---|---|---|---|
| StartTime | 是 | String | 查询起始时间。 | 2021-01-01 00:00:00 |
| EndTime | 是 | String | 查询结束时间，结束时间大于起始时间。 | 2021-01-01 23:59:59 |
| Domains | 是 | [ ]String | 指定查询域名列表，为空代表查询当前用户所有域名。 | [www.bytedance.com] |
Metrics | 是 | [ ]String | 指定查询指标，支持取值：
|
|
Interval | 否 | Integer | 时间粒度，单位为秒 ，支持参数：
|
|
Protocol | 否 | [ ]String | 指定客户端请求应用层和传输层协议查询，为空时表示查询所有协议，支持参数：
|
|
Type | 否 | String | 指定访问类型，不填时表示查询所有类型，返回总和（相当于all），支持参数：
|
|
IPVersion | 否 | String | 指定ip类型查询，不填时表示查询所有类型，支持参数：
|
|
注意
资源用量和实时监控接口的查询时间区别如下表。
| 具体指标 | 资源用量 | 实时监控 |
|---|---|---|
| 查询时支持查到的最早历史数据 | 90天前 | 7天前 |
| 查询时支持最大的查询时间跨度 | 31天 | 24小时 |
| 查询后数据展示的最小时间粒度 | 5分钟（可修改其他更大数值） | 1分钟（不可修改） |
参数名称 | 参数类型 | 参数说明 | 示例 |
|---|---|---|---|
RequestId | String | 请求ID。 | 2022******452201017424420806842536 |
DomainCount | Integer | 查询域名中有效域名的数量。 | 20 |
StartTime | String | 查询起始时间。 | 2021-01-01 00:00:00 |
EndTime | String | 查询结束时间。 | 2021-01-01 23:59:59 |
Metrics | [ ]String | 查询时选择展示的字段。 | ["bandwidth"] |
Results | Result | 查询数据明细。 | - |
POST https://open.volcengineapi.com/?Action=DescribeOriginStatisticsDetail&Version=2021-04-01&<其他公共请求参数> { "StartTime": "2022-08-09 00:00:00", "EndTime": "2022-08-09 00:20:11", "Domains":[ "www.qq.com", "www.bytedance.com" ], "Metrics": [ "all" ], "Interval": 300 }
{ "ResponseMetadata": { "RequestId": "202208100137510102251460630120605A", "Action": "DescribeOriginStatisticsDetail", "Version": "2021-04-01", "Service": "dcdn", "Region": "cn-north-1" }, "Result": { "DomainCount": 2, "StartTime": "2022-08-09 00:00:00", "EndTime": "2022-08-09 00:20:11", "Metrics": [ "all" ], "Results": [ { "TimeStamp": "2022-08-09 00:00:00", "RealTimeResults": [ { "DomainName": "www.bytedance.com", "DetailInfo": [ { "Name": "Traffic", "Value": 340791 }, { "Name": "Request", "Value": 168 }, { "Name": "QPS", "Value": 0.5599998 }, { "Name": "Bandwidth", "Value": 9087.320000000002 } ] }, { "DomainName": "www.qq.com", "DetailInfo": [ { "Name": "Traffic", "Value": 0 }, { "Name": "Request", "Value": 0 }, { "Name": "QPS", "Value": 0 }, { "Name": "Bandwidth", "Value": 0 } ] } ] }, { "TimeStamp": "2022-08-09 00:05:00", "RealTimeResults": [ { "DomainName": "www.bytedance.com", "DetailInfo": [ { "Name": "Traffic", "Value": 332618 }, { "Name": "Request", "Value": 164 }, { "Name": "QPS", "Value": 0.5466666 }, { "Name": "Bandwidth", "Value": 8869.300000000001 } ] }, { "DomainName": "www.qq.com", "DetailInfo": [ { "Name": "Traffic", "Value": 0 }, { "Name": "Request", "Value": 0 }, { "Name": "QPS", "Value": 0 }, { "Name": "Bandwidth", "Value": 0 } ] } ] }, { "TimeStamp": "2022-08-09 00:10:00", "RealTimeResults": [ { "DomainName": "www.bytedance.com", "DetailInfo": [ { "Name": "Traffic", "Value": 320546.60000000003 }, { "Name": "Request", "Value": 158 }, { "Name": "QPS", "Value": 0.526667 }, { "Name": "Bandwidth", "Value": 8547.220000000001 } ] }, { "DomainName": "www.qq.com", "DetailInfo": [ { "Name": "Traffic", "Value": 0 }, { "Name": "Request", "Value": 0 }, { "Name": "QPS", "Value": 0 }, { "Name": "Bandwidth", "Value": 0 } ] } ] }, { "TimeStamp": "2022-08-09 00:15:00", "RealTimeResults": [ { "DomainName": "www.qq.com", "DetailInfo": [ { "Name": "Traffic", "Value": 0 }, { "Name": "Request", "Value": 2 }, { "Name": "QPS", "Value": 0.0066666 }, { "Name": "Bandwidth", "Value": 0 } ] }, { "DomainName": "www.bytedance.com", "DetailInfo": [ { "Name": "Traffic", "Value": 348997 }, { "Name": "Request", "Value": 172 }, { "Name": "QPS", "Value": 0.5733332 }, { "Name": "Bandwidth", "Value": 9306.220000000001 } ] } ] }, { "TimeStamp": "2022-08-09 00:20:00", "RealTimeResults": [ { "DomainName": "www.bytedance.com", "DetailInfo": [ { "Name": "Traffic", "Value": 58793.9 }, { "Name": "Request", "Value": 29 }, { "Name": "QPS", "Value": 0.0966666 }, { "Name": "Bandwidth", "Value": 1567.7200000000003 } ] }, { "DomainName": "www.qq.com", "DetailInfo": [ { "Name": "Traffic", "Value": 0 }, { "Name": "Request", "Value": 0 }, { "Name": "QPS", "Value": 0 }, { "Name": "Bandwidth", "Value": 0 } ] } ] } ] } }