全部产品
视频直播

查询流控历史

更新时间:2017-09-19 11:32:16   分享:   

描述

获取某个域名或应用下的直播流操作记录。

请求参数

参数名 类型 是否必须 说明
Action String 操作接口名,系统规定参数,取值:DescribeLiveStreamsControlHistory
DomainName String 您的直播加速域名
AppName String 直播流所属应用名称
StartTime String 查询开始时间 UTC 时间 格式:2015-12-01T17:36:00Z
EndTime String 查询结束时间 UTC 时间 格式:2015-12-01T17:37:00Z,EndTime 和 StartTime 之间的间隔不能超过 30 天

返回参数

名称 类型 描述
ControlInfo LiveStreamControlInfo[] 直播流的操作记录

数据类型

LiveStreamControlInfo

名称 类型 描述
StreamName String 流的名字
ClientIP String 用户端的 IP 地址
Action String 执行的操作名称
TimeStamp String 操作执行的时间 UTC 时间

特殊错误码

错误代码 描述 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 结束时间与开始时间不匹配

示例

请求示例:

  1. https://live.aliyuncs.com?Action=DescribeLiveStreamsControlHistory&DomainName=test101.aliyunlive.com&StartTime=2015-06-25T03:30:50Z&EndTime=2015-12-01T17:37:00Z&<公共请求参数>

关于公共请求参数详细内容,请参考 公共请求参数

返回示例:

  • JSON 格式:
  1. {
  2. "ControlInfo": {
  3. "LiveStreamControlInfo": [
  4. {
  5. "Action": "forbid",
  6. "TimeStamp": "2015-12-01T16:36:18Z",
  7. "ClientIP": "10.207.197.201",
  8. "StreamName": "test101.aliyunlive.com/diaoliang/dd"
  9. }
  10. ]
  11. },
  12. "RequestId": "9C31856F-386D-4DB3-BE79-A0AA493D702A"
  13. }
  • XML 格式:
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <DescribeLiveStreamsControlHistoryResponse>
  3. <ControlInfo>
  4. <LiveStreamControlInfo>
  5. <Action>forbid</Action>
  6. <TimeStamp>2015-12-01T16:36:18Z</TimeStamp>
  7. <ClientIP>10.207.197.201</ClientIP>
  8. <StreamName>test101.aliyunlive.com/diaoliang/dd</StreamName>
  9. </LiveStreamControlInfo>
  10. </ControlInfo>
  11. <RequestId>9C31856F-386D-4DB3-BE79-A0AA493D702A</RequestId>
  12. </DescribeLiveStreamsControlHistoryResponse>
本文导读目录
本文导读目录
以上内容是否对您有帮助?