阿里云首页 视图计算

DescribeRecords

查询存储记录列表。

请求参数

注意:截图查询目前不支持分页,仅支持按迭代方式。使用返回结果里的extStartTime参数值,作为新请求的StartTime可请求下一页。

参数 类型 是否必要 示例值 描述
Action String DescribeRecords 操作接口名,系统规定参数。取值:DescribeRecords
Type String record 按存储记录类型查询。取值:record(录制),snapshot(截图)
StreamId String 32388487739092997 按流ID查询。
StartTime String 2018-12-10T17:00:00Z 按开始时间查询。
EndTime String 2018-12-10T18:00:00Z 按结束时间查询。
SortDirection String asc 排序方式,默认升序。取值:asc(升序),desc(降序)
PageSize Long 20 分页大小,默认为20。
Page Num Long 1 第几个分页,默认为1。

返回参数

参数 类型 示例值 描述
PageSize Long 20 分页大小。(仅限录制查询)
PageNum Long 1 第几个分页。(仅限录制查询)
PageCount Long 5 分页总数。(仅限录制查询)
TotalCount Long 100 存储记录总数。(仅限录制查询)
NextStartTime String 2018-12-10T17:00:00Z 查询下个记录的开始时间。(仅限截图查询)
Records Record[] 存储记录列表。
RequestId String BEA5625F-8FCF-48F4-851B-CA63946DA664 该条任务请求ID。

Record类型

参数 类型 示例值 描述
Id String f54522af-9907-44c1-af2e-b32958axxxx 存储记录ID。(仅限录制查询)
Type String record 存储记录类型。取值:record(录制),snapshot(截图)
FileFormat String hls 存储文件格式。取值:mp4,flv,hls,jpg
Url String http://xxx/xxx.mp4 存储文件的URL。
OssBucket String my_oss_bucket 存储文件的bucket。
OssObject String my/oss/object.mp4 存储文件的object。
StartTime String 2018-12-10T17:00:00Z 存储记录开始时间。
EndTime String 2018-12-10T18:00:00Z 存储记录结束时间。
Height Integer 1080 高度。
Width Integer 1920 宽度。

示例

请求示例

http://vs.aliyuncs.com?Action=DescribeRecords&<公共请求参数>
			

返回示例

{
    "RequestId": "BEA5625F-8FCF-48F4-851B-CA63946DA664",
    "PageSize": 20,
    "PageNum": 1,
    "PageCount": 5,
    "TotalCount": 100,
    "Records": [
        {
            "Id": "f54522af-9907-44c1-af2e-b32958axxxx",
            "Type": "record",
            "FileFormat": "mp4",
            "OssBucket": "my_oss_bucket",
            "OssObject": "my/oss/object.mp4",
            "Url": "http://xxx/xxx.mp4",
            "StartTime": "2018-12-10T17:00:00Z",
            "EndTime": "2018-12-10T18:00:00Z",
            "Height": 1080,
            "Width": 1920
        }
    ]
}