文档首页/ 需求管理 CodeArts Req/ API参考/ API/ Scrum项目的规划/ 建立工作项与甘特图的关联关系
更新时间:2025-08-11 GMT+08:00
分享

建立工作项与甘特图的关联关系

功能介绍

建立工作项与甘特图的关联关系。

调用方法

请参见如何调用API

URI

POST /v3/plan/{project_id}/{plan_id}/issue

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

正则表达式,[A-Za-z0-9]{32}。

取值范围:

不涉及。

默认取值

不涉及。

plan_id

String

参数解释:

发布/迭代唯一Id。可以通过发布/迭代计划列表查询接口获取,响应消息体中的id字段的值就是发布/迭代Id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

Array of integers

参数解释:

需要关联到甘特图的工作项列表id。

约束限制:

关联数量最大上限100。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

status

String

参数解释:

返回体的状态。

取值范围:

success:成功

error:失败

请求示例

{endpoint}//v3/plan/5192de5eb435430c8cd41c6ae6028848/f29c3f16d5f54cbab5e167ef9eed3baf/issue

[ 9192109, 9191020, 9184553, 9185630 ]

响应示例

状态码:200

响应体。

{
  "status" : "success"
}

状态码

状态码

描述

200

响应体。

错误码

请参见错误码

相关文档