全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
视频直播

查询截图信息

更新时间:2018-03-15 17:57:06

描述

查询一段时间内截图内容。

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribeLiveStreamSnapshotInfo

系统规定参数。取值:DescribeLiveStreamSnapshotInfo

AppName String testApp

直播流所属应用名称。

DomainName String www.yourdomain.com

您的加速域名。

EndTime String 2017-12-22T08:00:00:00Z

结束时间。

  • 格式:2015-12-01T17:36:00Z。
  • EndTime 和 StartTime 之间的间隔不能超过 1 天。

StartTime String 2017-12-21T08:00:00:00Z

开始时间。
格式:2015-12-01T17:36:00Z。

StreamName String testStream

直播流名称。

Limit Integer 10

一次调用获取的数量。
取值范围:[1,100]
默认值:10

返回参数

参数 类型 示例值 描述
RequestId String 62136AE6-7793-45ED-B14A-60D19A9486D3

该条任务请求 ID。

LiveStreamSnapshotInfoList

截图内容列表,没有则返回空数组。

  └CreateTime String 2015-12-01T17:36:00Z

截图产生时间。
格式:2015-12-01T17:36:00Z。

  └OssEndpoint String oss-cn-shanghai.aliyuncs.com

OSSEndpoint域名。

  └OssBucket String test123

OSSBucket的名称。

  └OssObject String test123

OSSObject名称。

NextStartTime String 2015-12-01T17:36:00Z

下一个起始时间。
当此时间范围内的内容超出了 limit 的数量限制,则返回此参数,表示下一个文件的创建时间,可以将此时间当做 StartTime,重新调用此接口获取下一段内容,不传则表示未超出 limit 数量。

示例

请求示例

  1. https://live.aliyuncs.com/?Action=DescribeLiveStreamSnapshotInfo&DomainName=xxxxx&AppName=aliyuntest&StreamName=xxx&StartTime=xxx&EndTime=xxx&<公共请求参数>

关于公共请求参数详细内容,参见 公共请求参数

正常返回示例

JSON 格式

  1. {
  2. "LiveStreamSnapshotInfoList":{
  3. "LiveStreamSnapshotInfo":[{
  4. "CreateTime":"2016-05-25T09:41:09Z",
  5. "OssBucket":"livevideo-test",
  6. "OssEndpoint":"oss-test.aliyun-inc.com",
  7. "OssObject":"{AppName}/{StreamName}.jpg"
  8. }]
  9. },
  10. "NextStartTime":"2015-12-01T17:36:00Z",
  11. "RequestId":"62136AE6-7793-45ED-B14A-60D19A9486D3"
  12. }

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

错误码

查看本产品错误码

本文导读目录