查询迭代计划列表,包含统计信息
功能介绍
查询迭代计划列表,包含统计信息
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 |
错误码
请参见错误码。