功能介绍
默认接口请求频率限制：500次/秒。
对指定设备/流启动按需录制任务，需要配合按需录制模板使用，请先在组或者设备上绑定按需录制模板。
接口约束
启动按需录制任务前，确保设备以及流在线且绑定录制模板为按需录制模板。
URI
GET /v1?
请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | StartRecordTask | 操作接口名，系统规定参数。 |
| DeviceId | String | 是 | 32388487739092996 | 设备ID。 |
| InProtocol | String | 是 | gb28181 | 使用的接入协议，默认gb28181。取值: gb28181, rtmp, rtsp, onvif, ehome, vgroup |
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| RecordTaskId | String | 录制任务ID，全局唯一标识录制任务。 |
| CreatedTime | String | 录制任务创建时间。 |
| UpdatedTime | String | 录制任务更新时间。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
示例
请求示例
GET https://vss-dsp-gzgy2-a.ctapi.ctyun.cn/v1?Action=StartRecordTask&DeviceId=29941966145847390&InProtocol=gb28181
Connection: keep-alive
ctyun-eop-request-id: 8b44ac8b-0620-48ef-9b35-e89098946c8a
Eop-date: 20221025T094830Z
Eop-Authorization: BLLOJSUVKOZ7RVV9VEFF Headers=ctyun-eop-request-id;eop-date Signature=ZeXIQdz1+id3OfzIOeAP/HPU1t8IzmvDRDqVFHlu76E=
Host: vss-dsp-gzgy1-a.ctapi-test.ctyun.cn
User-Agent: Apache-HttpClient/4.5.13 (Java/11.0.14)
返回示例
{
"RequestId": "4a7a8203023a4a4496e2d4f052273a94",
"RecordTaskId": "562530326547283969",
"CreatedTime": "2022-10-25 09:48:30",
"UpdatedTime": "2022-10-25 09:48:30"
}
