DescribeLiveStreamsPublishList - API Reference| Alibaba Cloud Documentation Center

Description

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	EndTime. 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	StartTime. 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
PublishInfo			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	10.175.60.33	Broadcaster IP.
└EdgeNodeAddr	String	10.175.30.21	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.

Example

Request example

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

{
    "PageNum":2,
    "PageSize":10,
    "PublishInfo":{
        "LiveStreamPublishInfo":[{
            "AppName":"xchen",
            "ClientAddr":"10.175.60.33",
            "DomainName":"test101.cdnpe.com",
            "EdgeNodeAddr":"10.175.30.21",
            "PublishDomain":"test101.cdnpe.com",
            "PublishTime":"2015-12-02T03:05:53Z",
            "PublishUrl":"rtmp://test101.cdnpe.com/xchen",
            "StopTime":"2015-12-02T03:11:19Z",
            "StreamName":"testxchen",
            "StreamUrl":"rtmp://xxx/xxxx"
        }]
    },
    "RequestId":"1C0E0C22-77B7-42AC-8212-AF99B2E0077F",
    "TotalNum":11,
    "TotalPage":2
}

Exception return example

JSON format

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

Error code

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