创建录制规则

最近更新时间:2025-02-21 02:50:54

1. 接口描述

接口请求域名: vssapi.ctyun.cn
默认接口请求频率限制:500次/秒。

创建录制规则,需要先调用CreateRecordTemplate接口创建录制模板,将返回的模板id绑定到指定组或设备/流。

2. 请求参数

参数类型是否必选示例值描述
ActionStringCreateRecordRule操作接口名,系统规定参数。
TemplateIdString1000模板ID。
GroupIdString32388487739092994组ID,二选一。
DeviceIdString31000000000000000002设备ID,二选一。
InProtocolStringgb28181使用的接入协议,默认gb28181。
取值: gb28181, rtmp, rtsp, onvif, ehome, vgroup

3. 返回参数

参数类型描述
TemplateIdLong模板ID。
GroupIdString组ID,二选一。
DeviceIdString设备ID,二选一。
CreatedTimeString录制规则创建时间。
UpdatedTimeString录制规则更新时间。
RequestIdString唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

4.1 请求示例

https://vssapi.ctyun.cn/
?Action=CreateRecordRule
&TemplateId=750395060025032704
&GroupId=1466353390796801
&Version=2020-06-12
&AccessKeyId=O0G0BPBI2T9YUD3U****
&Signature=4x93drpPg3iWPX50XA4aKYWCdlc%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=898940845
&SignatureVersion=1.0
&Timestamp=1599101776

4.2 返回示例

{
  "RequestId": "2e9111977ce548c48219f93fde7e606f",
  "TemplateId": "750395060025032704",
  "GroupId": "1466353390796801",
  "DeviceId": "",
  "CreatedTime": "2020-09-03 10:56:25",
  "UpdatedTime": "2020-09-03 10:56:25"
}

5. 错误码

ErrorCodeErrorMessage