查詢直播流錄制內(nèi)容
查詢直播錄制內(nèi)容。
使用說(shuō)明
先獲取主播流域名,再調(diào)用本接口查詢直播錄制內(nèi)容。
本接口的直播錄制內(nèi)容是以一次錄制任務(wù)維度的,具體錄制文件請(qǐng)使用查詢所有錄制索引文件和查詢單個(gè)錄制索引文件接口查詢
QPS限制
本接口的單用戶QPS限制為50次/秒。超過(guò)限制,API調(diào)用會(huì)被限流,這可能會(huì)影響您的業(yè)務(wù),請(qǐng)合理調(diào)用。更多信息,請(qǐng)參見(jiàn)QPS限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱(chēng) |
類(lèi)型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveStreamRecordContent | 系統(tǒng)規(guī)定參數(shù)。取值:DescribeLiveStreamRecordContent。 |
DomainName | String | 是 | example.com | 主播流域名。 |
AppName | String | 是 | liveApp**** | 播流所屬應(yīng)用名稱(chēng)。 |
StreamName | String | 是 | liveStream**** | 播流名稱(chēng)。 |
StartTime | String | 是 | 2017-12-21T08:00:00Z | 開(kāi)始時(shí)間。僅能查詢6個(gè)月內(nèi)的記錄。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
EndTime | String | 是 | 2017-12-22T08:00:00Z | 結(jié)束時(shí)間。與StartTime的間隔時(shí)間不能超過(guò)4天。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
返回?cái)?shù)據(jù)
名稱(chēng) |
類(lèi)型 |
示例值 |
描述 |
RequestId | String | 62136AE6-7793-45ED-B14A-60D19A9486D3 | 請(qǐng)求ID。 |
RecordContentInfoList | Array of RecordContentInfo | 錄制內(nèi)容列表。 |
|
RecordContentInfo | |||
EndTime | String | 2015-12-01T07:46:00Z | 結(jié)束時(shí)間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
StartTime | String | 2015-12-01T07:36:00Z | 開(kāi)始時(shí)間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
Duration | Float | 10 | 錄制時(shí)長(zhǎng)。單位:秒。 |
OssBucket | String | liveBucket**** | OSS存儲(chǔ)的Bucket名稱(chēng)。 |
OssObjectPrefix | String | record/{Date}/{UnixTimestamp}_{Sequence} | OSS存儲(chǔ)的錄制文件名的規(guī)則。 |
OssEndpoint | String | cn-oss-****.aliyuncs.com | OSS存儲(chǔ)的Endpoint名稱(chēng)。 |
示例
請(qǐng)求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamRecordContent
&AppName=liveApp****
&DomainName=example.com
&EndTime=2017-12-22T08:00:00Z
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream****
&<公共請(qǐng)求參數(shù)>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveStreamRecordContentResponse>
<RequestId>62136AE6-7793-45ED-B14A-60D19A9486D3</RequestId>
<RecordContentInfoList>
<RecordContentInfo>
<EndTime>2015-12-01T07:46:00Z</EndTime>
<OssEndpoint>cn-oss-****.aliyuncs.com</OssEndpoint>
<StartTime>2015-12-01T07:36:00Z</StartTime>
<OssBucket>liveBucket****</OssBucket>
<Duration>10</Duration>
<OssObjectPrefix>record/{Date}/{UnixTimestamp}_{Sequence}</OssObjectPrefix>
</RecordContentInfo>
</RecordContentInfoList>
</DescribeLiveStreamRecordContentResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DescribeLiveStreamRecordContentResponse" : {
"RequestId" : "62136AE6-7793-45ED-B14A-60D19A9486D3",
"RecordContentInfoList" : {
"RecordContentInfo" : {
"EndTime" : "2015-12-01T07:46:00Z",
"OssEndpoint" : "cn-oss-****.aliyuncs.com",
"StartTime" : "2015-12-01T07:36:00Z",
"OssBucket" : "liveBucket****",
"Duration" : 10,
"OssObjectPrefix" : "record/{Date}/{UnixTimestamp}_{Sequence}"
}
}
}
}
錯(cuò)誤碼
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime參數(shù)錯(cuò)誤,請(qǐng)您確認(rèn)該StartTime參數(shù)是否正確。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結(jié)束時(shí)間錯(cuò)誤,請(qǐng)您確認(rèn)結(jié)束時(shí)間是否正確。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 結(jié)束時(shí)間與開(kāi)始時(shí)間不匹配,請(qǐng)您確認(rèn)時(shí)間的匹配度。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。