文档首页/ 硬件开发工具链平台云服务/ API参考/ IPDCenter基础服务API/ 用户组织管理API/ 组织管理接口/ 部门管理接口/ 创建部门
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

创建部门

功能介绍

创建部门。

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

Object

返回数据

totalCount

Long

返回数据总条数

状态码： 400

表5 响应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
}

状态码： 400

认证失败

{
  "reserve" : null,
  "error_code" : "AUTH-600001",
  "error_msg" : ""
}

状态码

状态码

描述

200

成功

400

认证失败

500

服务器内部异常

错误码

请参见错误码。

父主题： 部门管理接口

相关文档