查询CDN统计信息
功能介绍
查询CDN的统计数据,包括流量、峰值带宽、请求总数、请求命中率、流量命中率。查询存在1小时误差。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1.0/{project_id}/asset/cdn-statistics
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
start_time |
否 |
String |
起始时间,格式为yyyymmddhhmmss。 |
end_time |
否 |
String |
结束时间,格式为yyyymmddhhmmss。
|
stat_type |
是 |
String |
统计数据类型。 取值如下:
每次只能查询一种统计数据。 |
domain |
是 |
String |
域名列表,多个域名以逗号(半角)分隔。 示例:example.test1.com,example.test2.com。 ALL表示查询名下全部域名。一次最多查询100个域名。 |
interval |
否 |
Integer |
查询粒度间隔。 取值如下:
单位:秒。 若不设置,默认取对应时间跨度的最小间隔。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
start_time |
String |
统计起始时间。 |
interval |
Integer |
统计间隔。 |
values |
Array of longs |
采样数据数组。 从start_time开始,每个间隔对应一个采样数据(其中流量单位:Byte,带宽单位:bps)。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
查询CDN统计数据
GET https://{endpoint}/v1.0/{project_id}/asset/cdn-statistics?domain=www.example.com&stat_type=cdn_bw
响应示例
状态码: 200
处理成功返回。
{ "start_time" : "string", "interval" : 0, "values" : [ 0 ] }
状态码: 400
处理失败返回。
{ "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
状态码
状态码 |
描述 |
---|---|
200 |
处理成功返回。 |
400 |
处理失败返回。 |
错误码
请参见错误码。