停用通道
更新时间:2022-02-17
接口描述
本接口用于停用GB28181设备的指定通道。
请求(Request)
请求URI
PUT /v1/device/channel/{channelId}?stop
参数名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
channelId | Long | 是 | 国标设备通道ID |
请求头域
除公共头域外,无其它特殊头域。
请求体
参数名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
recoverTime | Date | 否 | UTZ时间,形如"2021-04-01T12:00:00Z" |
注意: 如果请求体为空,则永久停用设备; 如果请求体包含recoverTime参数,则停用设备直到指定recoverTime时间。
响应(Response)
响应头域
除公共头域外,无其它特殊头域。
响应体
无。
示例
请求示例
PUT /v1/device/channel/1000001?stop HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
{
"recoverTime" : "2021-04-01T12:00:00Z"
}
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
错误码
错误码(code) | 消息(message) | 描述 | HTTP状态码 | |
---|---|---|---|---|
DeviceOperationNotPermitted | stop_channel not permitted, recover time should be after 3 minutes from now on | 恢复时间应该至少在3分钟以后 | 403 | |
DeviceOperationNotPermitted | stop_channel not permitted, recover time should be in 24 hours from now on | 恢复时间应该在24小时以内 | 403 | |
ChannelOperationNotPermitted | stop_channel not permitted for device type: GB28181, status: XXX | 当前状态不允许停用通道操作 | 403 |