查詢直播錄制任務
更新時間 2023-12-27 14:30:12
最近更新時間: 2023-12-27 14:30:12
分享文章
- 請求方式：
get - 請求路徑：
/live/record/query-record
請求參數說明
| 參數名 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| TaskID | string | 任務ID | 是 | 任務ID，對應任務創建時返回的ID，目前只支持單個任務 |
返回參數說明
| 參數名 | 類型 | 名稱 |
|---|---|---|
| code | int | 狀態碼，成功時為100000 |
| message | string | 描述信息，成功時為success |
| TaskList | list | 任務信息列表，目前只支持返回單個任務信息,詳細說明如下 |
| TaskList[*].TaskID | string | 任務ID |
| TaskList[*].TaskType | string | 任務類型，含義分別為： live-record：直播錄制 live-snapshot：直播截圖 live-ext-redirect：直播轉推 |
| TaskList[*].UniqName | string | 客戶標識 |
| TaskList[*].DomainName | string | 域名 |
| TaskList[*].App | string | 頻道名 |
| TaskList[*].Stream | string | 流名稱 |
| TaskList[*].Params | object | 轉碼參數，當taskType等于live-record或live-snapshot時存在 |
| TaskList[*].Params.Output | object array | 輸出參數 |
| TaskList[].Params.Output[ ].Format | string | 輸出文件的封裝格式 |
| TaskList[].Params.Output[ ].SegmentTime | string | 錄制文件分段時長,按固定文件時長輸出，單位秒 |
| TaskList[].Params.Output[ ].ResetTimestamps | int | 錄制起始時間戳，僅僅針對mp4,flv.aac有效 取值范圍為0和1，默認為1，分別表示： 0：分段文件起始時間戳不重置為0 1：分段文件起始時間戳重置為0 |
| TaskList[*].Params.OutTimeLink | string | 續錄的超時時長，單位秒 |
| TaskList[*].Params.XOSAccessKey | string | XOS存儲的訪問密鑰 |
| TaskList[*].Params.XOSSecretKey | string | XOS存儲的訪問密鑰 |
| TaskList[*].Params.XOSBucket | string | XOS存儲的Bucket名稱 |
| TaskList[*].Params.XOSRegion | string | XOS存儲的Region名稱 |
| TaskList[*].Params.XOSEndpoint | string | XOS存儲的服務地址 |
| TaskList[*].Params.RecordNotifyUrl | string | 錄制文件回調通知URL |
| TaskList[*].CreateTime | string | 任務創建時間，格式yyyy-MM-dd HH:mm:ss |
| TaskList[*].UpdateTime | string | 任務更新時間，格式yyyy-MM-dd HH:mm:ss |
| TaskList[*].TaskStatus | string | 任務執行狀態，有三種，分別是 “running” ：任務運行中 “finished” ：任務正常結束 “failed” ：任務失敗 |
| TaskList[*].ErrMsg | string | 任務具體錯誤信息 |
返回參數說明
| 參數名 | 類型 | 名稱 |
|---|---|---|
| code | int | 狀態碼，成功時為100000 |
| message | string | 描述信息，成功時為success |
| TaskID | string | 任務id |
調用示例
//cdnapi-global.ctapi.daliqc.cn/live/record/query-record
返回結果：
{
"code":100000,
"TaskList":[
{
"App":"test",
"TaskID":"123",
"DomainName":"daliqc.cn",
"ErrMsg":"Task scheduling exception",
"CreateTime":"2022-02-24 14:31:37",
"Params":{
"RecordNotifyUrl":"test",
"OssAccessKey":"test",
"OssEndpoint":"test",
"Output":[
{
"Format":"hls",
"ResetTimestamps":0,
"SegmentTime":"10"
}
],
"OssBucket":"test",
"OssSecretKey":"test",
"OssRegion":"test",
"OutTimeLink":"100"
},
"TaskStatus":"failed",
"Template":"None",
"Referrer":"open-api",
"UniqName":"1234",
"TaskType":"live-record",
"UpdateTime":"2022-02-24 14:31:37",
"Worker":"unknown",
"Stream":"test",
"SrcUrl":"None",
"DstUrl":""
}
],
"message":"success"
}
