All Products
Document Center


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

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

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

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://

The full streaming URL.

  └PublishDomain String

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.<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":"",
  9. "EdgeNodeAddr":"",
  10. "PublishDomain":"",
  11. "PublishTime":"2015-12-02T03:05:53Z",
  12. "PublishUrl":"rtmp://",
  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":"",
  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.