> For the complete documentation index, see [llms.txt](https://bm168x.gitbook.io/project/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bm168x.gitbook.io/project/v2r6c01_readme/xi-tong-dui-jie-shuo-ming-shu/dui-jie-se3-he-zi/3.2.3-yong-hu-guan-li/5.1.2-shan-chu-yong-hu-deleteusers.md).

# 3. 删除用户

**功能描述：**

删除一个或多个用户。

如果删除列表中的某个用户ID不存在，则会跳过删除此用户，继续执行其它用户的删除。

**参数描述（JSON格式）：**

| 一级参数           | 二级参数         | 类型     | 默认值 | 选择     | 说明                                                                                                                                                                                                           | 举例                                                                                                                                                                             |
| -------------- | ------------ | ------ | --- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| method         |              | string | 无   | **必选** | delete\_users                                                                                                                                                                                                | “delete\_users”                                                                                                                                                                |
| messageId      |              | string | 空   | 可选     | MQ消息的唯一标识ID                                                                                                                                                                                                  | “004a5b58-32e8-487e-a90a-2ce443877e7e”                                                                                                                                         |
| userid\_list   |              | list   | 无   | **必选** | 用户id列表                                                                                                                                                                                                       | \["user\_id1","user\_id2"]                                                                                                                                                     |
| extend\_params |              | dict   | 空   | 可选     | 扩展字段                                                                                                                                                                                                         |                                                                                                                                                                                |
|                | notify\_path | string | 无   | **必选** | <p>管理平台URL（相对地址），用于通过http方式回传命令执行结果。 相对地址的组合请参见 URL组合章节。<br>注意： 如果登陆时管理平台下发 uploadQueue 字段，则会通过MQ上传通道返回结果。<br>如果没有 uploadQueue 字段，并且 notify\_path 为非空，则会向 notify\_path 返回结果<br>如果两个字段都没有，则不会返回结果（即单向通信）。</p> | "[http://ip:port:/getResult](https://bm168x.gitbook.io/project/v2r6c01_readme/xi-tong-dui-jie-shuo-ming-shu/dui-jie-se3-he-zi/3.2.3-yong-hu-guan-li/http:/ip:port:/getResult)" |

**MQ命令示例：**

```json
{
    "method": "delete_users", //此关键字和内容不能变
    "userid_list": ["user_id1","user_id2"]， //用户id列表
    "extend_params": {
        "notify_path": "URL" // 返回mq命令处理结果的地址
    }  //扩展字段，里面内容可以为空，但字段为必选
}
```

**返回结果示例：**

```json
{
    "success":true，
    "code":0,
    "message":"删除人员MQ命令执行成功"，
    "dev_sno":"dasdas23123" ,//设备唯一标识key
    "messageKey":"delete_users" ,//每一类消息格式的key
    "result":{
        "success_users":[
                 {"userid":"12365", "message":"人员删除成功","code":0}，
                 {"userid":"12366", "message":"人员删除成功","code":0}
         ] ，                                                                        
        "failed_users":[
                {"userid":"12367", "message":"人员删除失败" , "code":40095}
        ]

    }
}
```