Create Organization Structure¶

创建组织结构节点。

请求格式¶

POST https://{apigw-address}/app-portal-service/v2.3/structure/create

请求参数（Query）¶

名称	必需/可选	数据类型	描述
orgId	必需	String	组织 ID。

请求参数（Body）¶

名称	必需/可选	数据类型	描述
structures	必需	StructureUpdateDTO 结构体	目标组织结构的列表。

StructureUpdateDTO 结构体¶

名称	必需/可选	数据类型	描述
parentId	必需	String	目标组织结构的根节点。
name	可选	I18nString	组织结构节点名称。名称规则参见国际化名称结构体。

响应参数¶

名称	数据类型	描述
structureIds	List	创建的各组织结构节点ID。

错误码¶

代码	描述
31400	组织结构节点名称不合法或根节点名称不匹配。
31403	应用无权访问组织结构。
31408	组织结构节点名称已经存在。
31415	组织结构、节点或层级数量超过限制。
31430	组织结构节点名称不合法。

示例¶

请求示例¶

url: https://{apigw-address}/app-portal-service/v2.3/structure/create
method: POST

requestBody:
{
    "structures": [
        {
            "parentId": "your_parent_node_id",
            "name": {
                "defaultValue": "Turbine",
                "i18nValue": {"zh_CN": "风机", "en_US": "Turbine"}
            }
        },
        {
            "parentId": "your_parent_node_id",
            "name": {
                "defaultValue": "RootTest"
            }
        }
    ]
}

返回示例¶

{
    "code": 0,
    "data": {
        "structureIds": ["structure_ID_1", "structure_ID_2"]
    },
    "message": "OK"
}