全部产品
Search

搜索本产品

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

    文档中心

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

    更新时间：Nov 05, 2024

    调用本接口获取直播转点播视频列表。

    接口说明

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

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    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
    LiveRecordVideoListarray<object>

    视频列表。

    LiveRecordVideoobject
    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 数组。

    Snapshotstring

    视频截图 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 分组个数超过限制。