All Products
Search
Document Center

ListLiveRecordVideo

Last Updated: Mar 04, 2019

Description

You can call this operation to obtain a list of VOD files created from live streams. You can obtain a maximum of 5,000 data records queried based on specified filter criteria.

Request parameters

NameTypeRequiredDescription
ActionStringYesThe operation that you want to perform. Set the value to ListLiveRecordVideo.
StreamNameStringNoThe name of the live stream from which a VOD is recorded.
DomainNameStringNoThe accelerating domain name of the live stream.
AppNameStringNoThe name of the application used for recording.
StartTimeStringNoThe start time of recording.
  • The value is an open interval, which indicates that the actual start time is later than the specified start time.
  • Specify a date in ISO 8601 format in UTC, that is, YYYY-MM-DDThh:mm:ssZ.
    For example, a value of 2017-01-11T12:00:00Z indicates 20:00:00 on January 11, 2017, Beijing time.
EndTimeStringNoThe end time of recording.
  • The value is a closed interval, which indicates that the actual end time is earlier than or the same as the specified end time.
  • Specify a date in ISO 8601 format in UTC, that is, YYYY-MM-DDThh:mm:ssZ.
    For example, a value of 2017-01-11T12:00:00Z indicates 20:00:00 on January 11, 2017, Beijing time.
PageNoLongNoThe page number. Default value: 1.
PageSizeLongNoThe number of data records per page. Maximum value: 100.Default value: 10.
SortByStringNoThe sorting rule of results. Valid values:
  • CreationTime:Desc
  • CreationTime:Asc
Default value: CreationTime:Desc (indicating that results are sorted based on the creation time in descending order).

Response parameters

NameTypeDescription
RequestId String The GUID generated by Alibaba Cloud for the request.
LiveRecordVideoList LiveRecordVideo[] The list of videos.
TotalIntegerThe total number of videos.

Examples

Sample requests

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=ListLiveRecordVideo&AppName=testApp&Format=JSON&<Common request parameters>

Note: For more information about common request parameters, see Common parameters.

Sample responses

JSON format

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "Total" : 100,
  4. "LiveRecordVideoList":{
  5. [
  6. {
  7. "StreamName": "xxx",
  8. "DomainName": "xxx",
  9. "AppName": "xxx",
  10. "PlaylistId": "xxx",
  11. "RecordStartTime":"2017-12-08T07:40:56Z",
  12. "RecordEndTime":"2017-12-08T09:26:17Z",
  13. "Video":
  14. {
  15. "VideoId": "93ab850b4f6f44eab54b6e91d24d81d4",
  16. "Title": "ApsaraVideo for VOD video title",
  17. "Description": "ApsaraVideo for VOD video description",
  18. "Duration": 135.6,
  19. "CoverURL": "https://image.example.com/coversample.jpg",
  20. "Status": "Normal",
  21. "CreationTime": "2017-06-26T05:38:48Z",
  22. "Size": 10897890,
  23. "Snapshots": {
  24. "Snapshot":[
  25. "http://image.example.com/snapshot/sample000001.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52",
  26. "http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52",
  27. ...
  28. ]
  29. },
  30. "CateId": 78,
  31. "CateName": "Category name",
  32. "Tags": "Tag 1,Tag 2"
  33. }
  34. }
  35. ]
  36. }
  37. }

Error codes

The following table lists the error codes that this operation can return. For more information, see Error codes.

Error codeError messageHTTP status codeDescription
VideoListExceededMaxThe video list exceeded maximum.400The error message returned when the total number of queried video records exceeds the upper limit.
InvalidVideo.NotFoundThe video does not exist.404The error message returned when the specified video does not exist.