功能介绍
默认接口请求频率限制：500次/秒。
查询录制规则列表。
接口约束
查询录制规则列表前确保录制模板存在。
URI
GET /v1?
请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeRecordRules | 操作接口名，系统规定参数。 |
| TemplateId | String | 是 | 1001 | 根据模板ID查询绑定该模板的组或设备。 |
| SortBy | String | 否 | GroupId | 选择按一个字段排序，可选值为： CreateTime、GroupId、DeviceId，默认为GroupId，按照先组后设备排序 |
| SortDirection | String | 否 | asc | 排序方式，默认升序。取值：asc(升序), desc(降序)。 |
| PageNum | Long | 否 | 1 | 第几个分页，默认为1。 |
| PageSize | Long | 否 | 20 | 分页大小，默认为20。取值范围为1～1000 |
| InProtocol | String | 否 | gb28181 | 使用的接入协议，默认gb28181。取值: gb28181, rtmp, rtsp, onvif, ehome, vgroup |
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| PageNum | Long | 第几个分页。 |
| PageSize | Long | 分页大小。 |
| TotalPage | Long | 分页总数。 |
| TotalNum | Long | 录制规则总数。 |
| RecordRules | RecordRule[] | 录制规则列表。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
RecordRule
| 参数 | 类型 | 描述 |
|---|---|---|
| TemplateId | Long | 模板ID。 |
| GroupId | String | 组ID，二选一。 |
| GroupName | String | 组名称。 |
| DeviceId | String | 设备ID，二选一。 |
| DeviceName | String | 设备名称。 |
| CreatedTime | String | 录制规则创建时间。 |
| UpdatedTime | String | 录制规则更新时间。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
示例
请求示例
GET https://vss-dsp-gzgy2-a.ctapi.ctyun.cn/v1?Action=DescribeRecordRules&TemplateId=448513221306826752
Connection: keep-alive
ctyun-eop-request-id: 586955a6-5d85-491e-8e2d-3759d9031fc7
Eop-date: 20221025T093915Z
Eop-Authorization: BLLOJSUVKOZ7RVV9VEFF Headers=ctyun-eop-request-id;eop-date Signature=dqnVZqHHs63GvtYG+s9Ek9bDQ7mYEbPOp1X5jAq6QNw=
Host: vss-dsp-gzgy1-a.ctapi-test.ctyun.cn
User-Agent: Apache-HttpClient/4.5.13 (Java/11.0.14)
返回示例
{
"PageNum": 1,
"PageSize": 20,
"TotalPage": 1,
"TotalNum": 20,
"RecordRules": [
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29941908163808405",
"CreatedTime": "2022-07-08 15:45:26",
"UpdatedTime": "2022-07-08 16:12:23",
"DeviceName": "storge",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29941916753724001",
"CreatedTime": "2022-09-17 13:25:49",
"UpdatedTime": "2022-09-17 13:25:49",
"DeviceName": "测试1",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29941938228579498",
"CreatedTime": "2022-10-08 14:45:35",
"UpdatedTime": "2022-10-19 09:13:00",
"DeviceName": "通道1",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29941961850885629",
"CreatedTime": "2022-09-24 17:51:41",
"UpdatedTime": "2022-09-24 17:51:41",
"DeviceName": "dghdhdh",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29941974735790260",
"CreatedTime": "2022-09-26 16:05:27",
"UpdatedTime": "2022-09-26 16:05:27",
"DeviceName": "回归测试",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29942002653069704",
"CreatedTime": "2022-06-29 18:12:38",
"UpdatedTime": "2022-06-29 18:12:38",
"DeviceName": "0629新建设备",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29942017685454901",
"CreatedTime": "2022-08-30 10:34:19",
"UpdatedTime": "2022-08-30 10:34:19",
"DeviceName": "通道1",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29942122912153796",
"CreatedTime": "2022-05-23 16:38:32",
"UpdatedTime": "2022-05-23 16:38:32",
"DeviceName": "0523-5",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29942133649571874",
"CreatedTime": "2022-08-25 18:31:54",
"UpdatedTime": "2022-08-25 18:32:01",
"DeviceName": "测试4",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29942135797055676",
"CreatedTime": "2022-05-23 16:29:58",
"UpdatedTime": "2022-05-23 16:29:58",
"DeviceName": "通道1",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29942135797055683",
"CreatedTime": "2022-09-15 15:30:30",
"UpdatedTime": "2022-09-27 14:47:00",
"DeviceName": "接口录像测试",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "29942168009310260",
"CreatedTime": "2022-08-30 10:33:54",
"UpdatedTime": "2022-08-30 10:33:54",
"DeviceName": "测试4",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "467635893177384960",
"CreatedTime": "2022-05-24 18:42:54",
"UpdatedTime": "2022-05-24 18:42:54",
"DeviceName": "0524-1",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "469155220679098370",
"CreatedTime": "2022-06-02 18:57:55",
"UpdatedTime": "2022-06-02 18:57:55",
"DeviceName": "通道2",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "561820007675559937",
"CreatedTime": "2022-09-28 16:13:17",
"UpdatedTime": "2022-09-28 16:14:17",
"DeviceName": "create7of",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "",
"DeviceId": "562767090910642176",
"CreatedTime": "2022-09-29 17:19:44",
"UpdatedTime": "2022-09-29 17:19:44",
"DeviceName": "录制管理接口查询录制规则",
"GroupName": ""
},
{
"TemplateId": "448513221306826752",
"GroupId": "466780825317982208",
"DeviceId": "",
"CreatedTime": "2022-05-27 22:31:45",
"UpdatedTime": "2022-09-17 13:34:50",
"DeviceName": "",
"GroupName": "测试一致性-gb"
},
{
"TemplateId": "448513221306826752",
"GroupId": "539522951244398592",
"DeviceId": "",
"CreatedTime": "2022-08-30 10:33:07",
"UpdatedTime": "2022-08-30 10:33:07",
"DeviceName": "",
"GroupName": "0829sbgl"
},
{
"TemplateId": "448513221306826752",
"GroupId": "551555826111578112",
"DeviceId": "",
"CreatedTime": "2022-09-15 16:36:45",
"UpdatedTime": "2022-09-15 16:36:45",
"DeviceName": "",
"GroupName": "接口测试0914"
},
{
"TemplateId": "448513221306826752",
"GroupId": "572186632796192768",
"DeviceId": "",
"CreatedTime": "2022-10-12 09:55:35",
"UpdatedTime": "2022-10-12 09:55:35",
"DeviceName": "",
"GroupName": "测试1111"
}
],
"RequestId": "1e77758353fd44c09c30dcb042334137"
}
