All Products
Document Center


Last Updated: Mar 19, 2018


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

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

Operation history of the live stream.

  └StreamName String StreamName

Name of the stream.

  └ClientIP String

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.


Request example

  1.<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":"",
  6. "StreamName":"",
  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":"",
  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.