edit-icon download-icon

DescribeLiveStreamsControlHistory

Last Updated: Mar 19, 2018

Description

Get the operation history on a live stream under a domain name or app.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeLiveStreamsControlHistory

The name of this interface. Value: DescribeLiveStreamsControlHistory

DomainName String Yes play.yourdomain.com

Your live domain name.

EndTime String Yes 2017-12-22T08:00:00:00Z

Query end time, in UTC. Format: 2015-12-01T17:37:00Z.

  • The time interval between EndTime and StartTime does not exceed 30 days.

StartTime String Yes 2017-12-21T08:00:00:00Z

Query start time, in UTC. Format: 2015-12-01T17:36:00Z.

AppName String No testApp

Name of the app, which the live stream belongs to.

Return parameters

Parameters Type Example values Description
ControlInfo

Operation history of the live stream.

  └StreamName String StreamName

Name of the stream.

  └ClientIP String 10.207.197.201

The client IP address.

  └Action String DescribeLiveStreamsControlHistory

Name of the action executed.

  └TimeStamp String 2015-12-01T16:36:18Z

Time when the action is run in UTC.

RequestId String 40A4F36D-A7CC-473A-88E7-154F92242566

The ID of the job request.

Example

Request example

  1. https://live.aliyuncs.com/?Action=DescribeLiveStreamsControlHistory&DomainName=test101.aliyunlive.com&StartTime=2015-06-25T03:30:50Z&EndTime=2015-12-01T17:37:00Z&<Public Request Parameter>

For more information, see Public Request Parameter.

Normal return example

JSON format

  1. {
  2. "ControlInfo":{
  3. "LiveStreamControlInfo":[{
  4. "Action":"forbid",
  5. "ClientIP":"10.207.197.201",
  6. "StreamName":"test101.aliyunlive.com/diaoliang/dd",
  7. "TimeStamp":"2015-12-01T16:36:18Z"
  8. }]
  9. },
  10. "RequestId":"9C31856F-386D-4DB3-BE79-A0AA493D702A"
  11. }

Exception return example

JSON format

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

Error code

For more information about error code of this product, see Error code.

Thank you! We've received your feedback.