# 查询迭代工作项 - ListQueryScrumVersion #### 功能介绍 查询迭代工作项。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI POST /v2/version/query-scrum-version #### 请求参数 表1请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 长度为10\~32768个字符。 **默认取值：** 不涉及。 | 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | projectUUId | 否 | String | **参数解释**： 项目的32位uuid，项目唯一标识，通过[查询项目列表](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32位的数字和字母组成的字符串。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | fixed_version_id | 否 | String | **参数解释：** 迭代id，可通过[获取指定项目的迭代列表](https://support.huaweicloud.com/api-projectman/ListProjectIterationsV4.html)接口获取指定项目的迭代列表。 **约束限制：** 不涉及。 **取值范围：** 最小值 0。 **默认取值：** 不涉及。 | | issueQuery | 否 | String | **参数解释：** 迭代工作项数量。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | subject | 否 | String | **参数解释：** 工作项标题 **约束限制：** 1\~200000个字符。 **取值范围：** 不涉及 **默认取值：** 不涉及。 | | tracker_id | 否 | String | **参数解释**： 工作项类型。 **约束限制**： 不涉及。 **取值范围**： 2（任务/Task） 3（缺陷/Bug） 5（Epic） 6（Feature） 7（Story） **默认取值**： 不涉及。 | | displayMode | 否 | String | **参数解释：** 显示模式。 **约束限制：** 不涉及。 **取值范围：** 不涉及 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | result | [result] object | **参数解释：** 查询迭代工作项的返回结果。 | | status | String | **参数解释：** 查询迭代工作项的返回状态。 **取值范围：** success：返回成功。 error：返回失败。 | 表4result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | issues | Array of [issues] objects | **参数解释：** 工作项列表。 | 表5issues | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | Array of [data] objects | **参数解释：** 工作项数据。 | | expectedHours | String | **参数解释：** 预计工时，（单位：人/时） **取值范围：** 不涉及。 | | time | String | **参数解释：** 工作时间,时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 | | user | [user] object | **参数解释：** 用户。 | 表6data | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 2025-07-11 | Array of [IssueNew] objects | **参数解释：** 7月11号的工作项数据。 | 表7IssueNew | 参数 | 参数类型 | 描述 | |:---|:---|:---| | updated_on | String | **参数解释：** 工作项的更新日期。时间戳格式（示例：1839340800000） 。 **取值范围：** 不涉及。 | | story_point | [StoryPoint] object | **参数解释：** 工作项的故事点。 **取值范围：** 不涉及。 | | subject | String | **参数解释：** 工作项的负责者。 **取值范围：** 不涉及。 | | project | [Project] object | **参数解释：** 项目。 **取值范围：** 不涉及。 | | isParent | Boolean | **参数解释：** 是否有子工作项。 **取值范围：** true（有子工作项） false（没有子工作项） | | done_ratio | Integer | **参数解释：** 工作项完成度。 **取值范围：** 不涉及。 | | findReleaseDev | String | **参数解释：** 发布人 。 **取值范围：** 不涉及。 | | tracker | [Tracker] object | **参数解释：** 工作项的类型。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 工作项列表id。 **取值范围：** 不涉及。 | | start_date | String | **参数解释：** 工作项的开始日期。时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 | | assigned_to | [assigned_to] object | **参数解释：** 工作项责任人。 **取值范围：** 不涉及。 | | status_attribute | [StatusAttributeVO] object | **参数解释：** 工作项的状态属性。 **取值范围：** 不涉及。 | | severity | [Severity] object | **参数解释：** 重要程度。 **取值范围：** 不涉及。 | | releaseDev | String | **参数解释：** 工作项发布版本号。 **取值范围：** 不涉及。 | | author | [author] object | **参数解释：** 工作项负责人。 **取值范围：** 不涉及。 | | module | Object | **参数解释：** 工作项的模块。 **取值范围：** 不涉及。 | | due_date | String | **参数解释：** 工作项的截止日期，时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 | | expected_work_hours | Integer | **参数解释：** 工作项的预计工时(单位：人时)。 **取值范围：** 不涉及。 | | priority | [Priority] object | **参数解释：** 优先级。 **取值范围：** 不涉及。 | | actual_work_hours | Integer | **参数解释：** 工作项的实际工时（单位：人/时）。 **取值范围：** 不涉及。 | | is_watcher | Boolean | **参数解释：** 是否关注 。 **取值范围：** true（是） false（不是） | | deleted | Boolean | **参数解释：** 是否删除 。 **取值范围：** true（是） false（不是） | | fixed_version | Object | **参数解释：** 问题解决版本。 **取值范围：** 不涉及。 | | is_archived | Boolean | **参数解释：** 是否归档。 **取值范围：** true（是） false（不是） | | created_on | String | **参数解释：** 工作项的创建时间，时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 | | domain | Object | **参数解释：** 工作项的领域 。 **取值范围：** 不涉及。 | | developer | Object | **参数解释：** 工作项的开发人员。 **取值范围：** 不涉及。 | | closeder | Object | **参数解释：** 关闭人员。 **取值范围：** 不涉及。 | | position | String | **参数解释：** 工作项在列表的展示位置 。 **取值范围：** 不涉及。 | | closed_flag | Integer | **参数解释：** 关闭标志 。 **取值范围：** 0（打开） 1（关闭） | | assigned_cc_user | String | **参数解释：** 工作项的抄送人。 **取值范围：** 不涉及。 | | custom_value_new | Object | **参数解释：** 自定义字段。 **取值范围：** 不涉及。 | | status | [Status] object | **参数解释：** 工作项的状态。 **取值范围：** 不涉及。 | 表8StoryPoint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 故事点id。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 故事点名称。 **取值范围：** 不涉及。 | 表9Project | 参数 | 参数类型 | 描述 | |:---|:---|:---| | identifier | String | **参数解释：** 项目uuid。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 项目名称。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 项目数字id。 **取值范围：** 不涉及。 | | type | String | **参数解释：** 项目类型。 **取值范围：** scrum。 | 表10Tracker | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 类型名称。 **取值范围：** - Task。 - Bug。 - Epic。 - Feature。 - Story。 | | id | Integer | **参数解释：** 类型id。 **取值范围：** 2（任务/Task） 3（缺陷/Bug） 5（Epic） 6（Feature） 7（Story） | 表11assigned_to | 参数 | 参数类型 | 描述 | |:---|:---|:---| | firstName | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | lastName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 | | identifier | String | **参数解释：** 用户32位uuid。 **取值范围：** 不涉及。 | | image_id | String | **参数解释：** 用户头像id。 **取值范围：** 不涉及。 | | assignedNickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 用户数字id。 **取值范围：** 不涉及。 | 表12StatusAttributeVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 项目id。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 名称。 **取值范围：** 不涉及。 | 表13Severity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 工作项的重要程度。 **取值范围：** - 关键 - 重要 - 一般 - 提示 | | id | Integer | **参数解释：** 重要程度id。 **取值范围：** 10 （关键） 11 （重要） 12 （一般） 13 （提示） | 表14author | 参数 | 参数类型 | 描述 | |:---|:---|:---| | firstName | String | **参数解释：** 用户名称。 **取值范围：** 不涉及。 | | lastName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 | | identifier | String | **参数解释：** 作者唯一标识。 **取值范围：** 不涉及。 | | image_id | String | **参数解释：** 用户头像id。 **取值范围：** 不涉及。 | | authorNickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 带租户信息的用户名（租户名称_用户名）。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 用户id。 **取值范围：** 不涉及。 | 表15Priority | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 工作项的优先级。 **取值范围：** - 低。 - 中。 - 高。 | | id | Integer | **参数解释：** 优先级id 。 **取值范围：** 1（低） 2（中） 3（高） | 表16Status | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 状态名称 **取值范围：** 新建 进行中 已解决 测试中 已关闭 已拒绝 | | id | Integer | **参数解释：** 状态id。 **取值范围：** 1（新建） 2（进行中） 3（已解决） 4（测试中） 5（ 已关闭） 6（已拒绝） | 表17user | 参数 | 参数类型 | 描述 | |:---|:---|:---| | firstName | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | lastName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 | | imageId | String | **参数解释：** 用户头像id。 **取值范围：** 不涉及。 | | assignedNickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 用户数字id。 **取值范围：** 不涉及。 | #### 请求示例 ``` POST https://{endpoint}/v2/version/query-scrum-version { "projectUUId" : "5192de5eb435430c8cd41c6ae6028848", "fixed_version_id" : "26664788", "issueQuery" : "7", "subject" : "", "tracker_id" : "7,2,3", "displayMode" : "member" } ``` #### 响应示例 **状态码：200** ``` { "result" : { "issues" : [ { "data" : [ { "2025-07-11" : [ { "subject" : "积分功能数据库设计、实现", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Task", "id" : 2 }, "id" : 69782376, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { "path" : "5939806", "name" : "会员管理", "id" : 5939806, "path_name" : "会员管理" }, "due_date" : "1752249600000", "expected_work_hours" : 8, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已关闭", "id" : 5 } }, { "subject" : "积分规则设计", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Task", "id" : 2 }, "id" : 69782377, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { "path" : "5939806", "name" : "会员管理", "id" : 5939806, "path_name" : "会员管理" }, "due_date" : "1752422400000", "expected_work_hours" : 16, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已关闭", "id" : 5 } }, { "subject" : "配件数据库设计", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Task", "id" : 2 }, "id" : 69782399, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { }, "due_date" : "1752768000000", "expected_work_hours" : 8, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已关闭", "id" : 5 } }, { "subject" : "配件管理页面前端开发", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Task", "id" : 2 }, "id" : 69782400, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { }, "due_date" : "1752940800000", "expected_work_hours" : 12, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已关闭", "id" : 5 } }, { "subject" : "配件统计报表结构设计", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Task", "id" : 2 }, "id" : 69782401, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { }, "due_date" : "1753113600000", "expected_work_hours" : 26, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已关闭", "id" : 5 } }, { "subject" : "查找产品功能开发", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Task", "id" : 2 }, "id" : 69782418, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { }, "due_date" : "1753459200000", "expected_work_hours" : 24, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已解决", "id" : 3 } }, { "subject" : "报表统计页面开发", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Task", "id" : 2 }, "id" : 69782402, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { }, "due_date" : "1753286400000", "expected_work_hours" : 24, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已关闭", "id" : 5 } }, { "subject" : "积分管理 - 无法显示积分规则界面", "project" : { "identifier" : "381fcca9c056482d92da3e8b9da71db5", "name" : "DevOps全流程示例项目xxxx" }, "findReleaseDev" : "", "tracker" : { "name" : "Bug", "id" : 3 }, "id" : 69782387, "releaseDev" : "", "assigned_to" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 }, "status_attribute" : { }, "severity" : { "name" : "一般", "id" : 12 }, "author" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "name" : "hw19145027", "id" : 233087, "authorNickName" : "asdf4" }, "module" : { }, "due_date" : "1752595200000", "expected_work_hours" : 8, "priority" : { "name" : "中", "id" : 2 }, "actual_work_hours" : 0, "is_watcher" : false, "deleted" : false, "fixed_version" : { "name" : "迭代3", "id" : 21723087 }, "domain" : { }, "developer" : { }, "closeder" : { }, "assigned_cc_user" : [ ], "status" : { "name" : "已关闭", "id" : 5 } } ] } ], "expectedHours" : "126.0", "time" : "1755482637394", "user" : { "firstName" : "hw_008618814464665_01", "lastName" : "hw19145027", "imageId" : "photo01.png", "assignedNickName" : "asdf4", "name" : "hw19145027", "id" : 233087 } } ] }, "status" : "success" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询迭代工作项接口成功的响应。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。