# 查询分组/SophonFogSys/api/groups（GET）

**功能描述**

查询一个分组，或是放回所有的分组，组名具有唯一性。

**调用URL**

<http://192.168.1.180:5555/SophonFogSys/api/groups>

调用方法: GET

**请求参数**

| 参数          | 类型     | 默认值 | 选择 | 描述                       | 举例 |
| ----------- | ------ | --- | -- | ------------------------ | -- |
| group\_name | string | 空   | 可选 | 分组名称，如果该参数没有设置，则返回所有的分组。 |    |

请求示例：

```json
请求url: http://192.168.1.180:5555/SophonFogSys/api/groups?
```

**返回信息：**

请求成功

| 一级参数 | 二级参数         | 三级参数        | 类型     | 描述                                                                                                                   |
| ---- | ------------ | ----------- | ------ | -------------------------------------------------------------------------------------------------------------------- |
| data |              |             | dict   |                                                                                                                      |
|      | groups\_list |             | list   | "groups\_list": \[ { "description": "负责系统软件开发", "name": "10391" }, { "description": "负责系统软件开发", "name": "软件开发一部" } ] |
|      |              | name        | string | 分组名称                                                                                                                 |
|      |              | description | string | 分组信息，内容可为‘’                                                                                                          |

请求成功示例：

```json
{
    "data": {
        "groups_list": [
            
            {
                "name": "default_group"，
                "description": "默认比对用户组"
            }
        ]
    }
}
```

请求失败

| 一级参数  | 二级参数    | 类型     | 描述    |
| ----- | ------- | ------ | ----- |
| error | code    | int    | 请求错误码 |
|       | message | string | 错误描述  |
|       | status  | string | 错误类型  |
