# 创建分组/SophonFogSys/api/permissions（POST）

**功能描述**

新建一个权限组，组名具有唯一性。

**调用URL**

http://192.168.1.180:5555/SophonFogSys/api/permissions

调用方法: POST

**请求参数（JSON格式）**

| 参数               | 类型     | 默认值 | 选择 | 描述                                           | 举例           |
| ---------------- | ------ | --- | -- | -------------------------------------------- | ------------ |
| permission\_name | string | 无   | 必选 | 权限组名称，内容不可为‘’,可支持中文。不支持在字符串中间包含“,”，代码暂时不做校验。 | ”测试组“        |
| description      | string | 无   | 必选 | 权限组信息，内容可为‘”“, 即空字符串                         | ”该权限组为测试权限组“ |
| info             | dict   | 无   | 可选 | 权限组其他内容添加, 不能在info中携带name和description字段      |              |

请求示例：

```json
请求url: http://192.168.1.180:5555/SophonFogSys/api/permissions
请求body:
        {
            "permission_name":"测试组",
            "description":"该权限组为测试权限组"
        }
```

**返回信息：**

请求成功

| 一级参数 | 二级参数 | 三级参数        | 类型     | 描述                 |
| ---- | ---- | ----------- | ------ | ------------------ |
| data |      |             | dict   |                    |
|      | info |             | dict   |                    |
|      |      | name        | string | 权限组名称              |
|      |      | description | string | 权限组信息，内容可为”“， 即空符串 |

请求成功示例：

```json
{
    "data": {
        "info": {
            "name": "测试组",
            "description": "该权限组为测试权限组"
        }
    }
}
```

请求失败

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