# 创建部门 - CreateDepartment
#### 功能介绍
创建部门。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0034.html)。
#### URI
POST /basic/mgmt/public/api/v1/organization/group
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| Authorization | 是    | String | JWTToken |
   
表2请求Body参数 
| 参数   | 是否必选 | 参数类型                                                                                                                                      | 描述     |
|:---|:---|:---|:---|
| 数组元素 | 是    | Array of [createGroupExt] objects | 创建部门请求 |
   
 表3createGroupExt 
| 参数            | 是否必选 | 参数类型    | 描述                           |
|:---|:---|:---|:---|
| groupcode     | 是    | String  | 部门编码（需唯一）                    |
| name          | 是    | String  | 部门名称                         |
| nameEn        | 是    | String  | 部门英文名称                       |
| employeeLimit | 是    | Integer | 人数限制，默认50                    |
| manager       | 否    | String  | 部门管理员ID                      |
| parentId      | 否    | String  | 父级部门                         |
| id            | 否    | String  | 部门ID，部门数据的主键ID，不传时由系统生成，不可重复 |
| groupType     | 否    | String  | 部门来源，如果不传此字段，则默认设置为isv       |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型                                                                             | 描述      |
|:---|:---|:---|
| code       | String                                                                           | 返回码     |
| message    | String                                                                           | 返回码描述   |
| datas      | Array of [XDMUserGroupViewDTO] | 返回数据    |
| totalCount | Long                                                                             | 返回数据总条数 |
   
 表5XDMUserGroupViewDTO 
| 参数               | 参数类型                                                              | 描述     |
|:---|:---|:---|
| id               | String                                                            | 角色ID   |
| name             | String                                                            | 角色名称   |
| nameEn           | String                                                            | 英文名称   |
| groupcode        | String                                                            | 部门编码   |
| groupType        | String                                                            | 部门来源   |
| description      | String                                                            | 描述     |
| descriptionEn    | String                                                            | 英文描述   |
| creator          | String                                                            | 创建人    |
| createTime       | Timestamp                                                         | 创建时间   |
| rdmVersion       | Integer                                                           | 系统版本   |
| rdmDeleteFlag    | Integer                                                           | 是否删除标识 |
| modifier         | String                                                            | 修改人    |
| className        | String                                                            | 类名     |
| disableFlag      | Boolean                                                           | 失效标识   |
| rdmExtensionType | String                                                            | 扩展类型   |
| tenant           | [TenantViewDTO] | 租户     |
| lastUpdateTime   | Timestamp                                                         | 最新更新时间 |
   
 表6TenantViewDTO 
| 参数               | 参数类型                                                              | 描述         |
|:---|:---|:---|
| id               | String                                                            | 租户ID       |
| rdmVersion       | Integer                                                           | 系统版本       |
| creator          | String                                                            | 创建人        |
| kiaguid          | String                                                            | KIA密级      |
| code             | String                                                            | 租户编码       |
| rdmDeleteFlag    | Integer                                                           | 是否删除标识     |
| modifier         | String                                                            | 修改人        |
| description      | String                                                            | 描述         |
| className        | String                                                            | 类名         |
| name             | String                                                            | 名称         |
| nameEn           | String                                                            | 英文名称       |
| securityLevel    | String                                                            | 安全密级       |
| createTime       | Timestamp                                                         | 创建时间       |
| disableFlag      | Boolean                                                           | 失效标识       |
| rdmExtensionType | String                                                            | 扩展类型       |
| dataSource       | String                                                            | 租户使用的数据源名称 |
| tenant           | [TenantViewDTO] | 租户         |
| lastUpdateTime   | Timestamp                                                         | 最新更新时间     |
   
**状态码： 400**
表7响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| reserve    | String | 保留字段 |
| error_code | String | 错误编码 |
| error_msg  | String | 错误信息 |
   
#### 请求示例
```
[
    {
        "employeeLimit": 30,
        "manager": "2000001",
        "parentId": "743547113639518208",
        "name": "group01",
        "nameEn": "group01",
        "groupcode": "GSK001"
    }
]
```
#### 响应示例
**状态码： 200**
成功
```
{
    "code": "IPDC.01020000",
    "message": "success",
    "datas": [
        {
            "id": "755756557492293632",
            "creator": "public@ipdcenter203.huaweiapaas.com 2891572111",
            "modifier": "public@ipdcenter203.huaweiapaas.com 2891572111",
            "createTime": "2025-04-21T03:46:44.584+00:00",
            "lastUpdateTime": "2025-04-21T03:46:44.584+00:00",
            "rdmVersion": 1,
            "rdmDeleteFlag": 0,
            "rdmExtensionType": "XDMUserGroup",
            "tenant": {
                "id": "-1",
                "creator": "xdmAdmin",
                "modifier": "xdmAdmin",
                "createTime": "2023-10-31T07:44:53.458+00:00",
                "lastUpdateTime": "2023-10-31T07:44:53.458+00:00",
                "rdmVersion": 1,
                "rdmDeleteFlag": 0,
                "rdmExtensionType": "Tenant",
                "tenant": null,
                "className": "Tenant",
                "name": "basicTenant",
                "description": "默认租户",
                "kiaguid": null,
                "securityLevel": "internal",
                "nameEn": null,
                "code": "basicTenant",
                "disableFlag": false,
                "dataSource": "DefaultDataSource"
            },
            "className": "XDMUserGroup",
            "groupcode": "GSK7374421",
            "nameEn": "test7374421",
            "descriptionEn": null,
            "name": "test7374421",
            "description": "test7374421",
            "disableFlag": false
        }
    ],
    "totalCount": 1
}
```
**状态码： 401**
认证失败
```
{
  "error_code" : "IPDC.02010034",
  "error_msg" : "Authorization token incorrect"
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 成功      |
| 401 | 认证失败    |
| 500 | 服务器内部异常 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-craftartsipdcenter/ErrorCode.html)。