接口描述
描述:
设置指定会议的录制文件是否转存。
设置仅支持对专网会议录制生效,如果会议为公网会议则返回失败。
通过会议录制 ID 设置录制是否转存, 根据混合云集群是否开启转存:
如果混合云集群已开启录制转存功能。
对指定的会议录制可通过API设置转存,和转存完成后的删除策略。
如果录制未加入转存任务或转存失败, 则将录制加入转存任务。
如果录制已加入转存任务, 或转存已完成, 则返回失败。
如果混合云集群未开启专网会议录制转存。
不支持通过 API 设置会议录制的转存, 返回失败。
请求方式:PUT
鉴权方式:JWT 鉴权
接口请求域名:
https://api.meeting.qq.com/v1/records/transfer-recording?meeting_id={meeting_id}&meeting_record_id={meeting_record_id}
输入参数
请求路径参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_id | 是 | String | 会议 ID。 |
meeting_record_id | 是 | String | 会议录制 ID,列表接口返回的 meeting_record_id。 |
请求 body 参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_id | 是 | String | 操作者 ID,根据 operator_id_type 的值,使用不同的类型。 |
operator_id_type | 是 | Integer | 操作者 ID 的类型: 1:userid |
instanceid | 是 | Integer | 用户的终端设备类型: 0:PSTN 1:PC 2:Mac 3:Android 4:iOS 5:Web 6:iPad 7:Android Pad 8:小程序 9:h.323/sip 设备 10:Linux 20:Rooms for Touch Windows 21:Rooms for Touch MacOS 22:Rooms for Touch Android 30:Controller for Touch Windows 32:Controller for Touch Android 33:Controller for Touch iOS |
delete_recording_after_transfer | 否 | String | 如果参数未带, 则按集群删除策略对指定录制删除操作。 0 : 转存完成后立刻删除录制文件。 1~30 : 转存完成后1~30天后删除录制文件。 -1: 转存完成后不删除录制文件。 |
输出参数
成功时返回空消息体,失败时返回错误码和错误信息。
示例
输入示例
PUThttps://api.meeting.qq.com/v1/records/transfer-recording?meeting_record_id=1123456789&meeting_id=12345678{"operator_id":"user1","operator_id_type":1,"instanceid":1,"delete_recording_after_transfer":"-1"}
输出示例
{}