停用设备
更新时间：2022-02-17
接口描述
本接口用于停用EVS设备。
请求（Request）
请求URI
PUT /v1/device/{deviceId}?disable
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| deviceId | Long | 是 | 设备ID |
注意： 如果请求的deviceId是RTMP设备，则将停用这条rmpt流； 如果请求的deviceId是GB28181设备，则将停用这个设备的所有通道。
请求头域
除公共头域外，无其它特殊头域。
请求体
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| recoverTime | Date | 否 | UTZ时间，形如"2021-04-01T12:00:00Z" |
注意： 如果请求体为空，则永久停用设备； 如果请求体包含recoverTime参数，则停用设备直到指定recoverTime时间。
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
无。
示例
请求示例
PUT /v1/device/1000001?disable 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 |
| DeviceOperationNotPermitted | disable not permitted for device type: GB28181, status: XXX | 当前状态不允许停用操作 | 403 |