查询迭代计划列表，包含统计信息
功能介绍
查询迭代计划列表，包含统计信息
URI
POST /GT3KServer/v4/iterators/batch-query
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
否 |
String |
迭代计划名称（支持模糊搜索） |
|
filter |
否 |
IteratorListFilterInfo object |
过滤条件 |
|
own |
否 |
Boolean |
是否是我的 |
|
branch_uri |
否 |
String |
分支URI |
|
iterator_uri |
否 |
String |
迭代计划URI |
|
owner_ids |
否 |
Array of strings |
迭代计划责任人集合 |
|
project_uuid |
是 |
String |
项目ID |
|
current_stage |
否 |
String |
迭代计划所处节点 |
|
page_no |
否 |
Integer |
当前页数 |
|
page_size |
否 |
Integer |
每页条数 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
pi_sprints |
否 |
Array of IssueListPiFilterInfo objects |
pi过滤条件 |
|
plan_end_date_start |
否 |
String |
计划结束间过滤开始时间点 |
|
plan_end_date_end |
否 |
String |
计划结束时间过滤结束时间点 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 |
|
value |
Array of IteratorVersionSummaryVo objects |
实际的数据类型：单个对象，集合 或 NULL |
|
reason |
String |
业务失败的提示内容 |
|
page_size |
Integer |
每页展示条数 |
|
page_no |
Integer |
页码 |
|
has_more |
Boolean |
是否有更多 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
uri |
String |
资源URI |
|
type |
String |
资源类型 |
|
author |
String |
创建人 |
|
name |
String |
名称 |
|
rank |
Integer |
级别 |
|
version |
String |
待测版本 |
|
owner |
String |
处理者ID |
|
creator |
String |
创建人ID |
|
iterations |
String |
关联迭代 |
|
description |
String |
描述 |
|
region |
String |
区域 |
|
last_modifier |
String |
最后修改人 |
|
last_modified |
String |
最后修改时间 |
|
last_modified_timestamp |
Long |
修改时间时间戳 |
|
last_change_time |
String |
最后变更时间 |
|
version_uri |
String |
版本URI |
|
origin_uri |
String |
源资源URI |
|
parent_uri |
String |
父资源URI |
|
parent_path |
String |
父资源路径 |
|
creation_version_uri |
String |
创建版本URI |
|
creation_date |
String |
创建时间 |
|
creation_date_timestamp |
Long |
创建时间时间戳 |
|
author_name |
String |
创建人名称 |
|
comment |
String |
备注 |
|
number |
String |
编号 |
|
is_master |
Integer |
是否为Master分支 |
|
is_iterator |
Integer |
是否为迭代 |
|
plan_start_date |
String |
开始时间 |
|
plan_end_date |
String |
结束时间 |
|
service_id |
String |
微服务ID |
|
service_name |
String |
微服务名 |
|
pbi_id |
String |
PBI ID |
|
pbi_name |
String |
PBI信息 |
|
plan_id |
String |
计划ID |
|
metric_pbi_ids |
String |
度量PBI ID |
|
metric_pbi_id_names |
String |
度量PBI名称 |
|
last_syn_date |
String |
最后同步时间 |
|
is_closed |
String |
版本是否关闭 |
|
asyn_git |
String |
是否同步git库 |
|
schema_no |
Integer |
schema编号 |
|
finish_date |
String |
迭代实际完成时间 |
|
owner_name |
String |
处理者名称 |
|
creator_name |
String |
创建人名称 |
|
current_stage |
String |
当前所处阶段 |
|
service_types |
String |
服务类型 |
|
risk_rating |
Integer |
风险等级 |
|
risk_des |
String |
风险描述 |
|
project_uuid |
String |
项目ID |
|
domain_id |
String |
租户ID |
|
pi_id |
String |
pi的id |
|
start_date |
String |
计划开始时间 |
|
start_date_timestamp |
Long |
计划开始时间时间戳 |
|
end_date |
String |
计划结束时间 |
|
end_date_timestamp |
Long |
计划结束时间时间戳 |
|
actual_start_date |
String |
实际开始时间 |
|
actual_start_date_timestamp |
Long |
实际开始时间时间戳 |
|
actual_end_date |
String |
实际完成时间 |
|
actual_end_date_timestamp |
Long |
实际开始时间时间戳 |
|
is_expired |
String |
是否超期 |
|
expired_info |
String |
计划过期信息,空代表不超期，否则给出具体超期信息 |
|
stages |
Array of strings |
迭代计划，默认包含design,execute,report |
|
design |
DesignSummaryVo object |
设计阶段信息汇总 |
|
execute |
ExecuteSummaryVo object |
执行阶段信息汇总 |
|
report |
ReportSummaryVo object |
报告阶段信息汇总 |
|
branch_uri |
String |
所属分支URI |
|
branch_name |
String |
所属分支名称 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
issue_num |
Integer |
需求总数 |
|
issue_cover_num |
Integer |
已覆盖需求数 |
|
case_num |
Integer |
用例数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
execute_case_num |
Integer |
已执行用例数 |
|
defect_num |
Integer |
缺陷总数 |
|
completed_defect_num |
Integer |
已完成缺陷数 |
|
case_success_rate |
String |
测试用例通过率 |
|
case_execution_rate |
String |
用例执行率 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
请求示例
POST https://{endpoint}/GT3KServer/v4/iterators/batch-query
{
"project_uuid" : "761e569574894180b3ecadc9d9df52b6",
"branch_uri" : "v901000106dij34m",
"name" : "计划1",
"current_stage" : "",
"page_no" : 1,
"page_size" : 10
}响应示例
状态码：200
OK
{
"total" : 1,
"value" : [ {
"uri" : "v901000107paa4eo",
"type" : "TestVersion",
"author" : "85f7cd3cd8784307a5bb194321bef3c1",
"name" : "计划1",
"version" : "基线_版本",
"owner" : "85f7cd3cd8784307a5bb194321bef3c1",
"creator" : "85f7cd3cd8784307a5bb194321bef3c1",
"iterations" : "[]",
"region" : {
"region" : null
},
"last_modifier" : "85f7cd3cd8784307a5bb194321bef3c1",
"last_modified" : "2025-02-26 10:55:32",
"last_modified_timestamp" : 1740538532000,
"last_change_time" : "2025-02-26 10:55:32",
"version_uri" : "v901000106dij34m",
"parent_uri" : "v901000106dij34m",
"parent_path" : "/761e569574894180b3ecadc9d9df52b6/v901000106dij34m/",
"creation_version_uri" : "v901000106dij34m",
"creation_date" : "2025-02-07 15:44:59",
"creation_date_timestamp" : 1738914299000,
"author_name" : "wtt_apitest",
"is_master" : 0,
"is_iterator" : 1,
"plan_start_date" : "2025-02-07 00:00:00",
"plan_end_date" : "2025-02-28 23:59:59",
"service_id" : "761e569574894180b3ecadc9d9df52b6",
"service_name" : "APITest（勿删）",
"schema_no" : 9,
"owner_name" : "wtt_apitest",
"creator_name" : "wtt_apitest",
"current_stage" : "execute",
"service_types" : "[\"0\",\"1\",\"12\",\"7\",\"8\"]",
"risk_rating" : 0,
"project_uuid" : "761e569574894180b3ecadc9d9df52b6",
"pi_id" : "notSelected",
"start_date" : "2025-02-07",
"start_date_timestamp" : 1738857600000,
"end_date" : "2025-02-28",
"end_date_timestamp" : 1740758399000,
"actual_start_date" : "2025-02-07",
"actual_start_date_timestamp" : 1738914359000,
"is_expired" : "0",
"expired_info" : "即将超期",
"stages" : [ "design", "execute", "report" ],
"design" : {
"issue_num" : 2,
"issue_cover_num" : 2,
"case_num" : 3
},
"execute" : {
"execute_case_num" : 3,
"defect_num" : 2,
"completed_defect_num" : 0,
"case_success_rate" : "66.7%",
"case_execution_rate" : "100.0%"
},
"report" : {
"case_success_rate" : "66.7%",
"case_complete_rate" : "66.7%"
},
"branch_uri" : "v901000106dij34m",
"branch_name" : "基线"
} ],
"page_size" : 10,
"page_no" : 1
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server Error |
错误码
请参见错误码。
