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.
|
StartTime | String | Yes | 2017-12-21T08:00:00:00Z | StartTime.
|
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.
|
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.
|
└StopTime | String | 2015-12-02T03:11:19Z | The time when streaming stops.
|
└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.