文档

ListLiveRecordVideo - 获取直播转点播视频列表

调用ListLiveRecordVideo获取直播转点播视频列表。

接口说明

最多支持获取指定筛选条件的前 5000 条。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vod:ListLiveRecordVideoRead
  • 全部资源
    *

请求参数

名称类型必填描述示例值
StreamNamestring

录制时使用的直播流名称。

live-test
DomainNamestring

录制时使用的直播域名。

example.com
AppNamestring

录制时使用的 App 名称。

testApp
PageNointeger

页号。默认值:1

1
PageSizeinteger

页长。最大值:100,默认值:10

10
SortBystring

结果排序。取值:

  • CreationTime:Desc(默认值):按创建时间倒序。
  • CreationTime:Asc:按创建时间升序。
CreationTime:Desc
StartTimestring

录制操作(开始直播节目录制)的开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-01-11T12:00:00Z
EndTimestring

录制操作(开始直播节目录制)的结束时间。需晚于开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-01-11T13:00:00Z

返回参数

名称类型描述示例值
object
Totalinteger

视频总条数。

123
RequestIdstring

请求 ID。

25818875-5F78-4A13-****-D7393642CA58
LiveRecordVideoListobject []

视频列表。

AppNamestring

App 名称。

testApp
PlaylistIdstring

播单 ID。

****
StreamNamestring

直播流名称。

live-test
RecordEndTimestring

录制结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-12-08T08:44:56Z
RecordStartTimestring

录制开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-12-08T07:40:56Z
DomainNamestring

域名。

example.com
Videoobject

视频信息。

CreationTimestring

视频创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-12-08T07:40:56Z
Statusstring

视频状态。取值:

  • Uploading:上传中。
  • UploadFail:上传失败。
  • UploadSuccess:上传完成。
  • Transcoding:转码中。
  • TranscodeFail:转码失败。
  • Blocked:屏蔽。
  • Normal:正常。
Normal
CateIdinteger

视频分类 ID。

78
VideoIdstring

视频 ID。

93ab850b4f6f*****54b6e91d24d81d4
Tagsstring

视频标签。多个标签使用英文逗号(,)分隔。

标签1, 标签2
CateNamestring

视频分类名称。

分类名
Descriptionstring

视频描述。

阿里云VOD视频描述
Sizelong

视频源文件大小。单位:字节。

10897890
CoverURLstring

视频封面 URL。

https://image.example.com/coversample.jpg
TemplateGroupIdstring

视频转码时使用的转码模板组 ID。

1
Durationfloat

视频时长。单位:秒。

135.6
Titlestring

视频标题。

阿里云VOD视频标题
ModifyTimestring

视频更新时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2017-12-08T09:40:56Z
Snapshotsarray

视频截图 URL 数组。

string

视频截图 URL 数组。

{"Snapshot":["http://image.example.com/snapshot/sample000001.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52","http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52"]}

示例

正常返回示例

JSON格式

{
  "Total": 123,
  "RequestId": "25818875-5F78-4A13-****-D7393642CA58",
  "LiveRecordVideoList": {
    "LiveRecordVideo": [
      {
        "AppName": "testApp",
        "PlaylistId": "****",
        "StreamName": "live-test",
        "RecordEndTime": "2017-12-08T08:44:56Z",
        "RecordStartTime": "2017-12-08T07:40:56Z",
        "DomainName": "example.com",
        "Video": {
          "CreationTime": "2017-12-08T07:40:56Z",
          "Status": "Normal",
          "CateId": 78,
          "VideoId": "93ab850b4f6f*****54b6e91d24d81d4",
          "Tags": "标签1, 标签2",
          "CateName": "分类名",
          "Description": "阿里云VOD视频描述",
          "Size": 10897890,
          "CoverURL": "https://image.example.com/coversample.jpg",
          "TemplateGroupId": "1",
          "Duration": 135.6,
          "Title": "阿里云VOD视频标题",
          "ModifyTime": "2017-12-08T09:40:56Z",
          "Snapshots": {
            "Snapshot": [
              "{\"Snapshot\":[\"http://image.example.com/snapshot/sample000001.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52\",\"http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52\"]}"
            ]
          }
        }
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

下表列举了本接口特有的错误码。视频点播通用的错误码信息,请参见错误码表

错误代码错误信息HTTP 状态码说明
IpsIsEmptyThe specified “Ips” can not be empty.400Ips 不允许为空。
IpsExceededMaxThe specified Ips count has exceeded 100.403添加的 IP 超过个数限制,每个分组最多支持 100 个。
SecurityIpGroupExceededMaxThe audit security group count has exceeded 10.403审核安全 IP 分组个数超过限制。