Create Organization Structure¶

在某一组织结构下创建节点。一次可创建多个节点。

请求格式¶

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

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	OU ID。如何获取 orgId 信息 >>

请求参数（Body）¶

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

StructureUpdateDTO 结构体 ¶

名称	必需/可选	数据类型	描述
parentId	必需	String	组织结构上的父节点 ID。
name	可选	I18nString	当前节点的名称，同一个父节点下的子节点不可重名。支持国际化，名称规则参见国际化名称结构体。

响应参数¶

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

错误码¶

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

示例¶

请求示例¶

url: https://{apigw-address}/app-portal-service/v2.3/structure/create?orgId=yourOrgId
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"
}