edit-icon download-icon


Last Updated: Apr 11, 2018


View the streaming history of a domain name (or an app under the domain name) within a period of time.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeLiveStreamsPublishList

The name of this interface. Value: DescribeLiveStreamsPublishList

DomainName String Yes play.yourdomain.com

Your Live domain name.

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


  • UTC format, for example: 2016-06-30T19:00:00Z.
  • The time interval betweem EndTime and StartTime does not exceed 30 days.

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


  • UTC format, for example: 2016-06-29T19:00:00Z.

AppName String No testApp

Name of the app, which the stream belongs to.

PageNumber Integer No 1

The page number.

Default value: 1

PageSize Integer No 1500

The page size.

  • Maximum: 3000.
  • Range: random integer between 1 and 3000.
Default value: 3000

StreamName String No testStream

Name of the live stream.

Return parameters

Parameters Type Example values Description

Streaming history informaiton.

  └DomainName String play.yourdomain.com

The CDN domain name, which the stream belongs to.

  └AppName String AppName

Name of the app, which the stream belongs to.

  └StreamName String StreamName

Name of the live stream.

  └StreamUrl String http://play.aliyunlive.com/AppName/StreamName.flv

The URL of live stream.

  └PublishTime String 2015-12-02T03:05:53Z

The time when streaming starts.

  • UTC time.

  └StopTime String 2015-12-02T03:11:19Z

The time when streaming stops.

  • UTC time.

  └ClientAddr String

Broadcaster IP.

  └EdgeNodeAddr String

The upstream node IP of CDN.

  └PublishUrl String rtmp://push.aliyunlive.com/AppName/StreamName

The full streaming URL.

  └PublishDomain String play.yourdomain.com

Streaming domain name.

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

The ID of the job request.

PageNum Integer 2

Page number.

PageSize Integer 10

The page size.

TotalNum Integer 11

The total number of eligible items.

TotalPage Integer 2

The total number of pages.


Request example

  1. https://live.aliyuncs.com?Action=DescribeLiveStreamsPublishList&DomainName=test101.aliyunlive.com&StartTime=2015-06-25T03:30:50Z&EndTime=2015-12-26T03:30:50Z&PageSize=10&PageNum=2&<Public Request Parameter>

For more inforamtion, see Public Request Parameter.

Normal return example

JSON format

  1. {
  2. "PageNum":2,
  3. "PageSize":10,
  4. "PublishInfo":{
  5. "LiveStreamPublishInfo":[{
  6. "AppName":"xchen",
  7. "ClientAddr":"",
  8. "DomainName":"test101.cdnpe.com",
  9. "EdgeNodeAddr":"",
  10. "PublishDomain":"test101.cdnpe.com",
  11. "PublishTime":"2015-12-02T03:05:53Z",
  12. "PublishUrl":"rtmp://test101.cdnpe.com/xchen",
  13. "StopTime":"2015-12-02T03:11:19Z",
  14. "StreamName":"testxchen",
  15. "StreamUrl":"rtmp://xxx/xxxx"
  16. }]
  17. },
  18. "RequestId":"1C0E0C22-77B7-42AC-8212-AF99B2E0077F",
  19. "TotalNum":11,
  20. "TotalPage":2
  21. }

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.