新建流水线分组
功能介绍
新建流水线分组
调用方法
请参见如何调用API。
URI
POST /v5/{project_id}/api/pipeline-group/create
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | 参数解释: 流水线分组名。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
| project_id | 是 | String | 参数解释: CodeArts项目ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
| parent_id | 否 | String | 参数解释: 父分组ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 分组ID。 取值范围: 32位字符,由数字和字母组成。 |
| domain_id | String | 参数解释: 租户ID,用户的domainId。 取值范围: 32位字符,由数字和字母组成。 |
| project_id | String | 参数解释: 项目ID。 取值范围: 32位字符,由数字和字母组成。 |
| name | String | 参数解释: 分组名。 取值范围: 32位字符,由数字和字母组成。 |
| parent_id | String | 参数解释: 父分组ID。 取值范围: 32位字符,由数字和字母组成。 |
| path_id | String | 参数解释: 分组路径ID。例如id1.id2.id3 代表分组id3的父分组为id2,分组id2的父分组为id1。 取值范围: 不涉及。 |
| ordinal | Integer | 参数解释: 序号。 取值范围: 大于等于0。 |
| creator | String | 参数解释: 创建用户ID。 取值范围: 32位字符,由数字和字母组成。 |
| updater | String | 参数解释: 更新用户ID。 取值范围: 32位字符,由数字和字母组成。 |
| create_time | Long | 参数解释: 创建时间。 取值范围: 不涉及。 |
| update_time | Long | 参数解释: 更新时间。 取值范围: 不涉及。 |
| children | Array of PipelineGroupVo objects | 参数解释: 流水线分组详情。 取值范围: 不涉及。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
| error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
请求示例
创建G1分组
POST https://{endpoint}/v5/{project_id}/api/pipeline-group/create
{
"name" : "G1",
"project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
"parent_id" : ""
} 响应示例
状态码:200
OK
{
"id" : "58d55f8a646443a984e7399632b3963e",
"domain_id" : "ce8df55870164338a72d7e828a966a2a",
"project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
"name" : "G1",
"parent_id" : "",
"path_id" : "58d55f8a646443a984e7399632b3963e",
"ordinal" : 1,
"creator" : "847a5317086c41798469d0868535943a",
"updater" : null,
"create_time" : null,
"update_time" : null,
"children" : null
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
错误码
请参见错误码。