功能介绍
默认接口请求频率限制：500次/秒。
查询录制模板。
接口约束
查询之前，确保存在该录制模板。
URI
GET /v1?
请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeRecordTemplate | 操作接口名，系统规定参数。 |
| TemplateId | String | 是 | 123 | 模板ID 。 |
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| TemplateId | String | 模板ID。 |
| TemplateName | String | 模板名称 |
| Description | String | 模板描述。 |
| RecordType | Long | 是否启用自动录制，默认1。取值：1(自动录制), 2(按需录制) |
| HlsParam | RecordParam | Hls录制参数。 |
| FlvParam | RecordParam | Flv录制参数。 |
| Mp4Param | RecordParam | Mp4录制参数。 |
| CreatedTime | String | 模板创建时间。 |
| UpdatedTime | String | 模板更新时间。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
RecordParam
| 参数 | 类型 | 描述 |
|---|---|---|
| Enable | Long | 是否开启当前格式录制，默认0。取值: 0(不开启), 1(开启) |
| Interval | Long | 录制间隔，单位秒，默认1800。 |
| StorageTime | Long | 存储时长，单位秒。默认0，0表示永久存储，604800表示一周。 |
| Path | String | 存储路径。默认为{DeviceId}/ record/ {StartTime} 支持的特殊占位符有： {DeviceId}: 设备ID {StartTime}: 文件开始时间 |
示例
请求示例
GET https://vss-dsp-gzgy2-a.ctapi.ctyun.cn/v1?Action=DescribeRecordTemplate&TemplateId=581845361410949120
Connection: keep-alive
ctyun-eop-request-id: 47fc4dd7-79b5-4f36-bdb5-f49686f29a2d
Eop-date: 20221025T101530Z
Eop-Authorization: BLLOJSUVKOZ7RVV9VEFF Headers=ctyun-eop-request-id;eop-date Signature=UWkzYSWmtcTEVVJmYlQdsEgiOf/tD5cExq9LjFfwkaI=
Host: vss-dsp-gzgy1-a.ctapi-test.ctyun.cn
User-Agent: Apache-HttpClient/4.5.13 (Java/11.0.14)
返回示例
{
"TemplateName": "录制模板 dfj",
"Description": "录制模板",
"RecordType": 1,
"HlsParam": {
"Enable": 0,
"Interval": 1800,
"StorageTime": 0,
"Path": "{DeviceId}/record/{StartTime}"
},
"FlvParam": {
"Enable": 0,
"Interval": 0,
"StorageTime": 0,
"Path": ""
},
"Mp4Param": {
"Enable": 0,
"Interval": 0,
"StorageTime": 0,
"Path": ""
},
"TemplateId": "581845361410949120",
"CreatedTime": "2022-10-25 10:15:30",
"UpdatedTime": "2022-10-25 10:15:30",
"RequestId": "370637a6a0794abf964491e124305c34"
}
