创建部门 - CreateDepartment

功能介绍

创建部门。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /basic/mgmt/public/api/v1/organization/group

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	JWTToken

表2 请求Body参数
参数	是否必选	参数类型	描述
数组元素	是	Array of createGroupExt objects	创建部门请求

表3 createGroupExt
参数	是否必选	参数类型	描述
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	返回数据总条数

表5 XDMUserGroupViewDTO
参数	参数类型	描述
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	最新更新时间

表6 TenantViewDTO
参数	参数类型	描述
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	服务器内部异常

错误码

请参见错误码。

父主题： 部门管理接口

上一篇：部门管理接口

下一篇：删除部门 - DeleteDepartment