首页 智能媒体服务 API参考指南 API目录 实时处理 实时媒体截图 ListLiveSnapshotFiles - 获取实时截图文件列表

ListLiveSnapshotFiles - 获取实时截图文件列表

调用ListLiveSnapshotFiles获取实时截图文件列表,可分页获取。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

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

截图任务ID。

****a046-263c-3560-978a-fb287782****
StartTimestring

开始时间。UTC时间,格式:yyyy-MM-ddTHH:mm:ssZ。

2022-02-02T00:00:00Z
EndTimestring

结束时间。UTC时间,格式:yyyy-MM-ddTHH:mm:ssZ。

  • EndTime和StartTime之间的间隔不能超过1天。
2022-02-02T23:59:59Z
Limitinteger

每次获取数量,[1, 100],默认为10。

10
SortBystring

排序,默认为asc。

desc
枚举值:
- asc: 按时间升序
- desc: 按时间倒序

返回参数

名称类型描述示例值
object

响应数据。

RequestIdstring

请求ID。

******11-DB8D-4A9A-875B-275798******
FileListarray

文件列表。

object
OssEndpointstring

OSS域名。

oss-cn-shanghai.aliyuncs.com
OssBucketstring

OSS bucket。

testbucket
OssObjectstring

OSS存储对象位置。

snapshot/****a046-263c-3560-978a-fb287782****/1660638613798.jpg
CreateTimestring

创建时间。

2022-02-02T22:22:22Z
CreateTimestamplong

创建时间戳,用于删除接口传参。

1619503516000
IsOverlayboolean

是否覆盖截图。

true
NextStartTimestring

下一页的开始时间,没有返回则表示结束翻页。

2022-02-02T22:22:22Z

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "FileList": [
    {
      "OssEndpoint": "oss-cn-shanghai.aliyuncs.com",
      "OssBucket": "testbucket",
      "OssObject": "snapshot/****a046-263c-3560-978a-fb287782****/1660638613798.jpg",
      "CreateTime": "2022-02-02T22:22:22Z",
      "CreateTimestamp": 1619503516000,
      "IsOverlay": true
    }
  ],
  "NextStartTime": "2022-02-02T22:22:22Z"
}

错误码

Http code错误码错误信息描述
400MissingParameter%s-
400InvalidParameter%s-
400MalformedStartTimeSpecified parameter StartTime is not valid.-
400MalformedEndTimeSpecified parameter EndTime is not valid.-
400EndTimeMismatchSpecified end time does not math the specified start time.-
403UserDisableUser is disable.-
403ForbiddenUser not authorized to operate on the specified resource.无权限执行该操作。(一般是由于账号未获得相应权限,参考 账号授权策略。)
403OperationDeniedYour account has not enabled the ICE service.账号未开通智能媒体生产服务。
404JobNotFoundNo such job.-
404NoValidSnapshotNo snapshots found with given parameters.-
500InternalErrorThe request processing has failed due to some unknown error.后台发生未知错误,请稍后重试或联系客服解决。

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

阿里云首页 智能媒体生产 相关技术圈