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

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

功能介绍

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

调用方法

请参见如何调用API

授权信息

当前API调用无需身份策略权限。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

约束限制

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:失败

请求示例

POST https://{endpoint}/v3/plan/5192de5eb435430c8cd41c6ae6028848/f29c3f16d5f54cbab5e167ef9eed3baf/issue

[ 9192109, 9191020, 9184553, 9185630 ]

响应示例

状态码:200

{
  "status" : "success"
}

状态码

状态码

描述

200

响应体。

错误码

请参见错误码

相关文档