查询网络流量明细
支持查询90天内的数据。
时间跨度最小支持1小时,最大不超过31天。
最多同时指定100个域名。
起始时间和结束时间需同时指定。开始时间、结束时间必须传毫秒级时间戳。采样间隔<=1小时,需为1小时整时刻点,如2020-07-01 08:00:00、2020-07-01 09:00:00;采样间隔>1小时,需为1天整时刻点,如2020-07-01 00:00:00、2020-07-02 00:00:00。
如果起始时间、结束时间不满足采样间隔的整时刻点,返回数据可能与预期不一致。
功能介绍
查询网络流量明细。
URI
GET /v1.0/cdn/statistics/flux-detail
请求消息
请求参数
请求参数如表1所示。
名称 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
start_time |
否 |
Long |
查询起始时间戳(单位:毫秒)。 |
end_time |
否 |
Long |
查询结束时间戳(单位:毫秒)。 |
domain_name |
是 |
String |
域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com ,ALL表示查询名下全部域名。 |
interval |
否 |
Integer |
采样间隔,单位:秒,取值说明: 时间跨度1天:5分钟、1小时、4小时、8小时。 时间跨度2~7天:5分钟、1小时、4小时、8小时、1天。 时间跨度8~31天:4小时、8小时、1天。 如果不传,默认取对应时间跨度的最小间隔。 如果需要传,则换算成秒。 |
enterprise_project_id |
否 |
String |
当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目。注意:当使用子账号调用接口时,该参数必传。 |
请求示例
请求路径示例
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/flux-detail?start_time=1534176000000&end_time=1534258800000&domain_name=www.example.com&interval=300&enterprise_project_id=0
响应消息
响应参数
响应参数如表2所示。
flux_detail参数说明
flux_detail参数说明如表3所示。
名称 |
参数类型 |
描述 |
---|---|---|
interval |
Integer |
采样间隔,单位:秒,取值说明: 时间跨度1天:5分钟、1小时、4小时、8小时,分别对应300秒、3600秒、14400秒和28800秒。 时间跨度2~7天:1小时、4小时、8小时、1天,分别对应3600秒、14400秒、28800秒和86400秒。 时间跨度8~31天:4小时、8小时、1天,分别对应14400秒、28800秒和86400秒。 如果不传,默认取对应时间跨度的最小间隔。 |
start_time |
Integer |
查询起始时间戳(单位:毫秒)。 |
end_time |
Integer |
查询结束时间戳(单位:毫秒)。 |
stat_type |
String |
统计类型。 |
values |
Array of integers |
流量数据列表,从start_time开始,每采样间隔生成一个采样点,按时间顺序排列(单位:Byte)。 |
{ "flux_detail": { "interval": 300, "values": [835038583,835038584], "start_time": 1534176000000, "end_time": 1534258800000, "stat_type" : "flux" } }
状态码
状态码请参见状态码。
错误码
请参见错误码。