功能介绍
默认接口请求频率限制:500次/秒。
创建录制规则,需要先调用CreaterRecordTemplate接口创建录制模板,将返回的模板id绑定到指定组或设备/流。
接口约束
创建录制规则前确保录制模板、所需绑定的组或者设备均存在。
URI
GET /v1?
请求参数
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateRecordRule | 操作接口名,系统规定参数。 |
TemplateId | String | 是 | 1000 | 模板ID。 |
GroupId | String | 否 | 32388487739092994 | 组ID,二选一。 |
DeviceId | String | 否 | 31000000000000000002 | 设备ID,二选一。 |
InProtocol | String | 否 | gb28181 | 使用的接入协议,默认gb28181。取值: gb28181, rtmp, rtsp, onvif, ehome, vgroup |
返回参数
参数 | 类型 | 描述 |
---|---|---|
TemplateId | Long | 模板ID。 |
GroupId | String | 组ID,二选一。 |
DeviceId | String | 设备ID,二选一。 |
CreatedTime | String | 录制规则创建时间。 |
UpdatedTime | String | 录制规则更新时间。 |
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
示例
请求示例
GET https://vss-dsp-gzgy2-a.ctapi.ctyun.cn/v1?Action=CreateRecordRule&GroupId=581822890142941184&TemplateId=581822898731991040
Connection: keep-alive
ctyun-eop-request-id: 4a2cd2c3-bac1-46cb-b9a9-b8b71a690a92
Eop-date: 20221025T093155Z
Eop-Authorization: BLLOJSUVKOZ7RVV9VEFF Headers=ctyun-eop-request-id;eop-date Signature=kp+FxJcPT3nVvFUtvyT/TVslMRIAThA04zzL80dEMRk=
Host: vss-dsp-gzgy1-a.ctapi-test.ctyun.cn
User-Agent: Apache-HttpClient/4.5.13 (Java/11.0.14)
返回示例
{
"RequestId": "abf67afc898d4e7fa68da094463dd371",
"TemplateId": "581822898731991040",
"GroupId": "581822890142941184",
"DeviceId": "",
"CreatedTime": "2022-10-25 09:31:55",
"UpdatedTime": "2022-10-25 09:31:55"
}