更新时间:2026-11-06 GMT+08:00
分享

批量创建包

功能介绍

批量创建包。

URI

POST /v1/modelproject/{uuid}/packages/batch-create

请求参数

表1 Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Path参数

参数

是否必选

参数类型

描述

uuid

是

String

参数解释:

软件建模工程id。

通过查询模型工程列表接口获取,响应消息体content中的model_project_uuid就是软件建模工程id。

约束限制:

由数字、字母、'-'组成。

取值范围:

32/36位字符。

默认取值:

不涉及。

表3 Query参数

参数

是否必选

参数类型

描述

version_uuid

是

String

参数解释:

分支uuid。master分支传空字符串。

通过查询工程分支信息获取。

约束限制:

由数字、字母、'-'组成。

取值范围:

空字符串、32/36位字符。

默认取值:

空字符串

表4 body参数

参数

参数类型

描述

package_infos

Arrays of package_infos objects

参数解释:

请求体参数。单次最多创建50个包

约束限制:

不涉及。

取值范围:

1-50个包数据

默认取值:

不涉及。

表5 package_infos 参数

参数

是否必选

参数类型

描述

package_name

是

String

参数解释:

包名称。

约束限制:

不能是空字符串或全空格

取值范围:

1-255个字符

默认取值:

不涉及。

parent_package_uuid

否

String

参数解释:

父包uuid,传空即在根目录下创建。

通过查询工程树接口获取,响应消息体content中的packages数组中的uuid就是包uuid。

约束限制:

由数字、字母、'-'组成。

取值范围:

空字符串、32/36位字符。

默认取值:

空字符串

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

status

String

参数解释:

接口返回的状态信息

取值范围:

success:执行成功,

failed:执行失败。

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及。

result

Object

参数解释:

响应对象。

取值范围:

不涉及。

表7 result参数

参数

参数类型

描述

content

Arrays of content objects

参数解释:

包响应体内容。

取值范围:

不涉及。

count

Integer

参数解释:

分页返回的总条数。

取值范围:

不涉及。

表8 content 参数

参数

参数类型

描述

model_project_uuid

String

参数解释:

软件建模工程id。

取值范围:

不涉及。

version_uuid

String

参数解释:

分支uuid。

取值范围:

不涉及。

uuid

String

参数解释:

包id。

取值范围:

不涉及。

name

String

参数解释:

包名称。

取值范围:

不涉及。

parent_uuid

String

参数解释:

工程树父节点uuid。

取值范围:

不涉及。

stereotype

String

参数解释:

包构造型。

取值范围:

不涉及。

type

String

参数解释:

包类型。

取值范围:

不涉及。

sequence

Integer

参数解释:

序号。

取值范围:

不涉及。

has_child

Boolean

参数解释:

是否包含子节点。

取值范围:

不涉及。

请求示例

POST https://{endpoint}/v1/modelproject/28d8b94447d04d158ab81db1b7154a05/packages/batch-create?version_uuid
body参数
{
    "package_infos": [
        {
            "package_name": "1",
            "parent_package_uuid": "3f7d4fec3784442aa2fe8a63344cbc8c"
        }
    ]
}

响应示例

状态码: 200

success

{
    "status": "success",
    "error_code": null,
    "error_msg": null,
    "result": {
        "content": [
            {
                "model_project_uuid": "28d8b94447d04d158ab81db1b7154a05",
                "version_uuid": "",
                "uuid": "a55f1e9d2f0e449a90709fdc393029b5",
                "name": "1",
                "stereotype": "package",
                "type": "Package",
                "parent_uuid": "3f7d4fec3784442aa2fe8a63344cbc8c",
                "sequence": 0,
                "has_child": false
            }
        ],
        "count": 1
    }
}

状态码

状态码

描述

200

success

错误码

参考错误码。

相关文档