# 1. 设备数据清理

**清除设备数据**

\*\*功能描述：\*\*此命令对SE AI计算盒上的相关数据进行擦除。

| 一级参数           | 二级参数         | 类型     | 默认值 | 选择     | 说明                                                                                                                                                                                                              | 举例                                                                                                                                                                             |
| -------------- | ------------ | ------ | --- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| method         |              | string | 无   | **必选** | wipe\_data                                                                                                                                                                                                      | “wipe\_data”                                                                                                                                                                   |
| messageId      |              | string | 无   | 可选     | MQ消息的唯一标识ID                                                                                                                                                                                                     | “004a5b58-32e8-487e-a90a-2ce443877e7e”                                                                                                                                         |
| wipe\_options  |              | dict   | 无   | **必选** | 需要清除的数据选项                                                                                                                                                                                                       |                                                                                                                                                                                |
|                | users        | bool   | 无   | **必选** | <p>是否删除人员底库信息<br>true：删除<br>false：不删除</p>                                                                                                                                                                       | false                                                                                                                                                                          |
|                | events       | bool   | 无   | **必选** | <p>是否删除人员识别记录事件<br>true：删除<br>false：不删除</p>                                                                                                                                                                     | false                                                                                                                                                                          |
|                | ..........   | 自定义    |     | 待选     | 保留将来使用                                                                                                                                                                                                          |                                                                                                                                                                                |
| extend\_params |              | dict   | 无   | **必选** | 扩展字段，可以为空                                                                                                                                                                                                       |                                                                                                                                                                                |
|                | notify\_path | string | 无   | 可选     | <p>管理平台URL（相对地址），用于通过http方式回传命令执行结果。 相对地址的组合请参见 URL组合章节。<br>注意：<br>如果登陆时管理平台下发 uploadQueue 字段，则会通过MQ上传通道返回结果。<br>如果没有 uploadQueue 字段，并且 notify\_path 为非空，则会向 notify\_path 返回结果<br>如果两个字段都没有，则不会返回结果（即单向通信）。</p> | "[http://ip:port:/getResult](https://bm168x.gitbook.io/project/v5r5c01_readme/xi-tong-dui-jie-shuo-ming-shu/dui-jie-se3-he-zi/3.2.6-xi-tong-guan-li/http:/ip:port:/getResult)" |

**MQ命令示例：**

```json
{
    "method": "wipe_data", // 此关键字和内容不能变
    "wipe_options": {
            "users":true,    //表示要删除用户数据
            "events":false       //表示不删除events数据
     }，
    "extend_params": {
            "notify_path": "URL" // 返回mq命令处理结果的地址
    }  // 扩展字段，当前为空。用于将来的接口升级。扩展字段的内容以字典的形式填充，但扩展字段本身为必选。
}
```

返回结果示例：

```json
{
    "success":true，
    "code":0,
    "message":"重置数据成功",
    "dev_sno":"adefs2341" ,//设备唯一标识key
    "messageKey":"wipe_data" ,//每一类消息格式的key
    "result":{
        "wipe_options":
                {"users":true, "events":false}      //返回重置数据时mq下发的重置选项                                                                    
    }
}
```