API名称：DescribeStatistics 。
API域名：open.volcengineapi.com。
API描述：查询域名的资源用量数据。
Action和Version需要放在请求 URL 后方参数中。
参数名称 | 是否必选 | 参数类型 | 参数说明 |
|---|---|---|---|
Action | 是 | String | API 名称，该参数的取值是 DescribeStatistics 。 |
Version | 是 | String | API 版本，该参数的取值是 2021-04-01 。 |
在使用该 API 提交请求时，请求正文中可以包含的参数如下。
参数名称 | 是否必选 | 参数类型 | 参数说明 | 示例 |
|---|---|---|---|---|
| StartTime | 是 | String | 查询起始时间。 | 2021-01-01 00:00:00 |
| EndTime | 是 | String | 查询结束时间，结束时间大于起始时间。 | 2021-01-01 23:59:59 |
| Domains | 是 | [ ]String | 指定查询域名列表，为空代表查询当前用户所有域名。 | [www.bytedance.com] |
| ProjectName | 否 | [ ]String | 指定查询域名所属的项目，为空代表查询当前用户所有项目。 | ["TEST"] |
Metrics | 是 | [ ]String | 指定查询指标，支持取值：
|
|
Interval | 否 | Integer | 时间粒度，单位为秒 ，支持参数：
|
|
IspNameEn | 否 | [ ]String | 指定运营商，为空时表示查询所有运营商，支持参数：
|
|
AcceleratingRegion | 否 | String | 加速区域，不填表示查询所有区域，支持参数：
|
|
AcceleratingScope | 否 | String | 加速区域范围，不填表示查询全球范围，支持参数：
|
|
Area | 否 | String | 客户端所在区域，不填表示查询所有区域，支持参数：
|
|
Region | 否 | [ ]String | 指定区域，为空时表示查询所有区域。当 Area为 China 或 Global 时，Region 支持的区域详见下表。 |
|
Protocol | 否 | [ ]String | 指定客户端请求应用层和传输层协议查询，为空时表示查询所有协议，支持参数：
|
|
Type | 否 | String | 指定访问类型，不填时表示查询所有类型，返回总和（相当于all），支持参数：
|
|
IPVersion | 否 | String | 指定ip类型查询，不填时表示查询所有类型，支持参数：
|
|
注意
资源用量和实时监控接口的查询时间区别如下表。
| 具体指标 | 资源用量 | 实时监控 |
|---|---|---|
| 查询时支持查到的最早历史数据 | 90天前 | 7天前 |
| 查询时支持最大的查询时间跨度 | 31天 | 24小时 |
| 查询后数据展示的最小时间粒度 | 5分钟（可修改其他更大数值） | 1分钟（不可修改） |
| Area 取值 | 对应 Region 的取值范围 |
|---|---|
| China | ["BJ", "AH", "CQ", "FJ", "GD", "GS", "GX", "GZ", "HA", "HB", "HE", "HI", "HK", "HL", "HN", "JL", "JS", "JX", "LN", "MO", "NM", "NX", "QH", "SC", "SD", "SH", "SN", "SX", "TJ", "TW", "XJ", "XZ", "YN", "ZJ", "OTHERS"] |
| Global | ["CHN", "CHE", "AZE", "PNG", "PSE", "FSM", "LVA", "KHM", "SPM", "MYS", "COG", "VNM", "GRD", "HND", "GUF", "WLF", "COK", "BFA", "LAO", "IOT", "SVK", "GUM", "MLI", "RWA", "SGS", "IRN", "BLR", "KEN", "SMR", "BVT", "MSR", "DOM", "GIN", "IMN", "BLZ", "NRU", "NFK", "TZA", "BHR", "LBY", "YEM", "ARE", "SXM", "CPV", "MKD", "HMD", "ZWE", "ESP", "ATG", "BGD", "TKM", "MYT", "IND", "GRC", "SAU", "PHL", "GHA", "ISR", "VGB", "JAM", "TON", "DNK", "TCA", "LBR", "NLD", "PAN", "VCT", "COM", "PYF", "SWE", "CRI", "GTM", "KNA", "TUV", "PAK", "TJK", "DZA", "FIN", "MHL", "SLV", "FJI", "PER", "WSM", "CAF", "ERI", "LSO", "GGY", "MAR", "CYP", "ISL", "GNB", "NOR", "IRQ", "VUT", "AND", "CXR", "JOR", "MEX", "MCO", "NER", "JPN", "FRA", "EST", "VEN", "UMI", "AUS", "PRT", "GIB", "LIE", "ALB", "KOR", "HRV", "MNE", "TUN", "QAT", "SGP", "COL", "CUB", "EGY", "ARG", "CHL", "LCA", "ZAF", "CCK", "NPL", "MTQ", "ATF", "THA", "SRB", "ETH", "SJM", "BDI", "PRK", "GNQ", "BMU", "UKR", "OMN", "SDN", "ZMB", "DEU", "MDG", "AIA", "GUY", "NIC", "GRL", "MMR", "LKA", "BEL", "PRY", "PRI", "MLT", "MNP", "IRL", "ABW", "CYM", "TCD", "CIV", "BRB", "ALA", "BGR", "HTI", "NIU", "COD", "DJI", "TGO", "ASM", "BIH", "KWT", "MWI", "MNG", "SYR", "KAZ", "BEN", "SHN", "UGA", "KIR", "SLE", "AFG", "UZB", "SEN", "REU", "TUR", "URY", "TTO", "NAM", "ITA", "BOL", "PCN", "BWA", "MDV", "VAT", "SSD", "CZE", "MUS", "SOM", "XKS", "SUR", "GBR", "BRA", "JEY", "ECU", "FLK", "NCL", "AGO", "MOZ", "POL", "PLW", "IDN", "SLB", "GMB", "LBN", "MAF", "BHS", "USA", "ARM", "GLP", "BTN", "CUW", "ESH", "ROU", "GEO", "NGA", "LTU", "VIR", "SYC", "ATA", "RUS", "TKL", "GAB", "CAN", "BRN", "STP", "NZL", "CMR", "SWZ", "TLS", "SVN", "LUX", "MDA", "HUN", "FRO", "MRT", "BLM", "AUT", "KGZ", "OTHERS"] |
| 为空 | 全部区域 |
参数名称 | 参数类型 | 参数说明 | 示例 |
|---|---|---|---|
RequestId | String | 请求ID。 | 2021121*****58010225133143064747B5 |
DomainCount | Integer | 查询域名中有效域名的数量。 | 20 |
StartTime | String | 查询起始时间。 | 2021-01-01 00:00:00 |
EndTime | String | 查询结束时间。 | 2021-01-01 23:59:59 |
Metrics | [ ]String | 查询时选择展示的字段。 | ["bandwidth","2xx"] |
Results | Result | 查询数据明细。 | - |
TotalStatistics | TotalStatistics | 查询数据汇总。 | - |
POST https://open.volcengineapi.com/?Version=2021-04-01&Action=DescribeStatistics&<其他公共请求参数> { "StartTime":"2023-10-26 00:00:00", "EndTime":"2023-10-26 14:00:00", "Domains":[ ], "Metrics":["all"], "ProjectName": [], "Interval":86400, }
{ "ResponseMetadata": { "RequestId": "20231026*****284B4CF8B1A3FEA6546DD", "Action": "DescribeStatistics", "Version": "2021-04-01", "Service": "dcdn", "Region": "cn-north-1" }, "Result": { "DomainCount": 7*2, "StartTime": "2023-10-26 00:00:00", "EndTime": "2023-10-26 14:00:00", "Metrics": [ "all" ], "Results": [ { "TimeStamp": "2023-10-26 00:00:00", "DetailInfo": [ { "Name": "Traffic", "Value": 2259034170000 }, { "Name": "Request", "Value": 526521 }, { "Name": "QPS", "Value": 36.22 }, { "Name": "Bandwidth", "Value": 1346561984.1813335 }, { "Name": "2xx", "Value": 512200 }, { "Name": "200", "Value": 512200 }, { "Name": "201", "Value": 0 }, { "Name": "3xx", "Value": 1 }, { "Name": "301", "Value": 1 }, { "Name": "302", "Value": 0 }, { "Name": "4xx", "Value": 13264 }, { "Name": "400", "Value": 738 }, { "Name": "403", "Value": 1 }, { "Name": "404", "Value": 8298 }, { "Name": "499", "Value": 490 }, { "Name": "5xx", "Value": 1056 }, { "Name": "500", "Value": 0 }, { "Name": "502", "Value": 110 }, { "Name": "504", "Value": 946 }, { "Name": "TrafficHitRate", "Value": 0.2924504898722762 }, { "Name": "RequestHitRate", "Value": 0.28488372093023256 }, { "Name": "ResponseTime", "Value": 6000.3661164511905 } ] } ], "TotalStatistics": { "2xx": 512200, "2xxRatio": 0.9728007050051185, "3xx": 1, "3xxRatio": 0.0000018992594787292434, "4xx": 13264, "4xxRatio": 0.025191777725864686, "5xx": 1056, "5xxRatio": 0.002005618009538081, "Bandwidth": 1346561984.1813335, "QPS": 36.22, "Request": 526521, "RequestHitRate": 0.28488372093023256, "ResponseTime": 6000, "Traffic": 2259034175418.9004, "TrafficHitRate": 0.2924504898722762 } } }