字段 | 类型 | 是否必填 | 示例 | 描述 |
Action | String | 是 | DescribeDomainRealTimeOriginData | 系统规定参数。取值:DescribeDomainRealTimeOriginData |
DomainName | String | 否 | xxx.com | 加速域名。若参数为空,值会被默认设置为all,默认返回所有加速域名合并后数据。支持批量查询(去重),多个用半角逗号(,)分隔,目前最多支持二十个加速域名。 |
StartTime | String | 是 | 2022-01-01T10:20:00Z | 获取数据起始时间点。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
EndTime | String | 是 | 2022-01-01T12:20:00Z | 获取数据结束时间点,需晚于起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Metric | String | 是 | flux | 查询类型,支持以下类型: flux:流量 bandwidth:带宽 5xx:http状态码,5开头 |
Interval | String | 否 | 5minutes | 统计时间粒度。取值:
默认按时间跨度决定,小于等于12小时以1分钟为粒度,大于12小时小于三天则以5分钟为粒度 大于三天小于7天则以一小时为粒度,大于7天则以天为粒度。 |
SpaceName | String | 否 | 122546 | 空间名称,不传按全部空间数据查询 |
参数名称 | 类型 | 示例值 | 描述 |
DomainName | String | xxx.com | 加速域名。返回所有加速域名合并后数据。支持批量查询(去重),多个用半角逗号(,)分隔。(主域名) |
Interval | String | minute | 统计时间粒度。具体描述参考请求中的interval |
Metric | String | flux | 查询类型 |
Data | Array of DataItem | 用量数据 |
DataItem
参数名称 | 类型 | 示例值 | 描述 |
TimeStamp | String | 2022-01-01T10:00:00Z | 时间片起始时刻。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Value | Object | 详细使用数据 不同metric对应的内容不同 具体如下见下表 |
metric类型与返回的value对照表
metric | value 类型 | value 单位 | value描述 |
flux | float | byte | 流量用量 |
bandwidth | float | bit/s | 带宽用量 |
5xx | Array of HttpCodeInfo | 5xx状态码 |
HttpCodeInfo
参数名称 | 类型 | 示例值 | 描述 |
Code | String | 500 | HTTP返回码。 |
Count | float | 24 | 数量 |
curl -X POST 'https://vod.streamlakeapi.com/?Action=DescribeDomainRealTimeOriginData' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'accessKey: adfasdfasdfasfasfsa' \
-d 'EndTime=2015-12-10T10:21:00Z&StartTime=2015-12-10T10:20:00Z&Metric=flux&<公共参数>'
HTTP/1.1 200 OK
Content-Type: application/json
{
"ResponseMeta": {
"RequestId":"CixgpmAFOYcAAAAAAAAAAw",
"ErrorCode":"",
"ErrorMessage":""
},
"ResponseData": {
"DomainName" : "example.com",
"Interval" : "minute",
"Metric" : "flux",
"Data" : [
{
"TimeStamp" : "2015-12-10T10:20:00Z",
"Value" : 0
}, {
"TimeStamp" : "2015-12-10T10:21:00Z",
"Value" : 0
}
]
}
}
ErrorCode | ErrorMessage | 状态码 | 说明 |
InvalidArgument | Invalid Parameter. | 400 | 参数错误。 |
InvalidArgument | Invalid Parameter StartTime. | 400 | StartTime参数错误。 |
InvalidArgument | Invalid Parameter EndTime. | 400 | EndTime参数错误。 |
InvalidArgument | interval Not Support | 400 | 传入了不支持的interval |
InvalidArgument | StartTime > EndTime | 400 | 开始时间大于结束时间 |
InvalidArgument | StartTime > the current time | 400 | 开始时间大于当前时间 |