閱讀318 返回首頁    go 小米 go 小米5

查詢截圖信息__直播流操作接口_API 手冊_CDN-阿裏雲

DescribeLiveStreamSnapshotInfo

描述

查詢一段時間內截圖內容

請求參數

參數 類型 是否必須 描述
Action String 是 操作接口名，係統規定參數，取值：DescribeLiveStreamSnapshotInfo
DomaiName String 是 您的播流域名
AppName String 是 直播流所屬應用名稱
StreamName String 是 直播流名稱
StartTime String 是 開始時間，UTC時間，格式：2015-12-01T17:36:00Z
EndTime String 是 結束時間，UTC時間，格式：2015-12-01T17:36:00Z，EndTime和StartTime之間的間隔不能超過1天
Limit Integer 否 一次調用獲取的數量，範圍1~100，默認值：10

返回參數

名稱 類型 描述
RequestId String 該條任務請求ID
LiveStreamSnapshotInfoList LiveStreamSnapshotInfo[] 截圖內容列表，沒有則返回空數組
NextStartTime String 下一個起始時間，當此時間範圍內的內容超出了limit的數量限製，則返回此參數，表示下一個文件的創建時間，可以將此時間當做StartTime，重新調用此接口獲取下一段內容，不傳則表示未超出limit數量

數據類型

LiveStreamSnapshotInfo

名稱 類型 描述
OssEndpoint String oss endpoit
OssBucket String oss存儲bucket名稱
OssObject String oss存儲的錄製文件名
CreateTime String 截圖產生時間，格式：2015-12-01T17:36:00Z

特殊錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
InvalidLimit.Malformed The specified value of parameter Limit contains invalid variable. 400 Limit參數不合法
InvalidStartTime.Malformed Specified StartTime is malformed. 400 開始時間錯誤
InvalidEndTime.Malformed Specified EndTime is malformed. 400 結束時間錯誤
InvalidEndTime.Mismatch pecified end time does not math the specified start time. 400 結束時間與開始時間不匹配
InvalidStream.NotFound The speicified stream does not exist. 400 直播流不存在

示例

請求示例：

  1. https://cdn.aliyuncs.com?Action=DescribeLiveStreamSnapshotInfo&DomainName=xxxxx&AppName=aliyuntest&StreamName=xxx&StartTime=xxx&EndTime=xxx&<公共請求參數>

返回示例

JSON格式：

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

最後更新：2016-12-06 16:32:06

  上一篇：go 查詢直播流的幀率和碼率__直播流操作接口_API 手冊_CDN-阿裏雲
  下一篇：go 查詢轉碼配置信息__直播流操作接口_API 手冊_CDN-阿裏雲