更新时间:2019-06-18 21:33
获取某一时间段内某个域名(或域名下某应用或某个流)的推流记录
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
Action | String | 是 | 操作接口名,系统规定参数,取值:DescribeVsStreamsPublishList |
DomainName | String | 是 | 您的域名 |
AppName | String | 否 | 直播流所属应用名称 |
StreamName | String | 否 | 直播流名称 |
QueryType | String | 否 | 指定是否模糊匹配流名称,取值:fuzzy、strict,对应模糊匹配、精准匹配 |
StartTime | String | 是 | 起始时间,UTC格式,例如:2016-06-29T19:00:00Z |
EndTime | String | 是 | 结束时间,UTC格式,例如:2016-06-30T19:00:00Z,EndTime和StartTime之间的间隔不能超过30天 |
PageSize | Integer | 否 | 每页大小,默认3000,最大3000,取值:1~3000之前的任意整数 |
PageNumber | Integer | 否 | 取得第几页,默认1 |
名称 | 类型 | 描述 |
---|---|---|
PublishInfo | LiveStreamPublishInfo[] | 推流记录信息 |
PageNum | Integer | 分页的页码 |
PageSize | Integer | 每页大小 |
TotalPage | Integer | 总页数 |
TotalNum | Integer | 符合条件的总个数 |
LiveStreamPublishInfo
名称 | 类型 | 描述 |
---|---|---|
DomainName | String | 流所属加速域名 |
AppName | String | 流所属应用名称 |
StreamName | String | 直播流名称 |
StreamUrl | String | 直播流的URL |
PublishTime | String | 开始推流时刻 UTC时间 |
StopTime | String | 停止推流时刻 UTC时间 |
ClientAddr | String | 主播IP |
EdgeNodeAddr | String | CDN上行节点IP |
PublishUrl | String | 推流完整URL地址 |
PublishDomain | String | 推流域名 |
PublishType | String | 推流类型,边缘推流:edge,中心推流:center |
Transcoded | String | 是否是转码流,yes:是,no:没有 |
TranscodeId | String | 若转码过,返回转码模板id |
错误代码 | 描述 | Http 状态码 | 语义 |
---|---|---|---|
InternalError | The request processing has failed due to some unknown error. | 500 | 后台发生未知错误 |
InvalidDomain.NotFound | The domain provided does not exist in our records. | 404 | 当前账户下未查到域名 |
IllegalOperation | Illegal domain operate is not permitted. | 403 | 不支持当前操作,如:非直播类域名 |
InvalidStartTime.Malformed | Specified parameter StartTime is not valid. | 400 | 开始时间错误 |
InvalidEndTime.Malformed | Specified parameter EndTime is not valid. | 400 | 结束时间错误 |
InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 400 | 结束时间与开始时间不匹配 |
请求示例:
https://vs.aliyuncs.com?Action=DescribeVsStreamsPublishList&DomainName=example.com&StartTime=2015-06-25T03:30:50Z&EndTime=2015-12-26T03:30:50Z&PageSize=10&PageNum=2&<公共请求参数>
返回示例
JSON格式:
{
"RequestId": "1C0E0C22-77B7-42AC-8212-AF99B2E0077F",
"PageNum": 2,
"PageSize": 10,
"TotalNum": 11,
"TotalPage": 2,
"PublishInfo": {
"LiveStreamPublishInfo": [
{
"DomainName": "example.com",
"AppName": "xchen",
"StreamName": "testxchen",
"StreamUrl": "rtmp://xxx/xxxx",
"PublishTime": "2015-12-02T03:05:53Z",
"StopTime": "2015-12-02T03:11:19Z",
"ClientAddr": "10.175.60.33",
"EdgeNodeAddr": "10.175.30.21",
"PublishUrl": "rtmp://example.com/xchen",
"PublishDomain": "example.com",
"PublishType": "center", //边缘推流edge,中心推流center
"Transcoded": "yes",
"TranscodeId": "small"
}
]
}
}
在文档使用中是否遇到以下问题
更多建议
匿名提交