文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 迭代管理/ 查询工作项相关联测试计划 - QueryIteratorByWorkitem
更新时间:2026-10-22 GMT+08:00
分享

查询工作项相关联测试计划 - QueryIteratorByWorkitem

功能介绍

此接口用于查询工作项相关联的测试计划

调用方法

请参见如何调用API。

URI

GET /v4/{project_id}/workitem/{workitem_id}/iterators

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。

workitem_id

是

String

参数解释

工作项ID

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

value

Array of TestVersionVo objects

查询工作项相关联测试计划返回数据

表3 TestVersionVo

参数

参数类型

描述

uri

String

参数解释:

资源URI

取值范围:

11-34位长度的字母、数字组成的字符串

type

String

参数解释:

资源类型

取值范围:

  • TestCase,用例。

  • Task,任务。

  • TestVersion,分支。

  • IteratorTestCase,迭代用例。

author

String

参数解释:

创建人

取值范围:

长度小于128个字符的字符串

name

String

参数解释:

名称

取值范围:

长度小于128个字符的字符串

rank

Integer

参数解释:

分支的优先级别

取值范围:

  • 1:低级别

  • 2:中低级别

  • 3:中高级别

  • 4:高级别

version

String

参数解释:

待测版本

取值范围:

不涉及

owner

String

参数解释:

处理者ID

取值范围:

长度小于128个字符的字符串

creator

String

参数解释:

创建人ID

取值范围:

长度小于128个字符的字符串

iterations

String

参数解释:

关联迭代

取值范围:

长度小于128个字符的字符串

description

String

参数解释:

描述

取值范围:

长度小于1024个字符的字符串

region

String

参数解释:

区域

取值范围:

不涉及

last_modifier

String

参数解释:

最后修改人

取值范围:

长度小于128个字符的字符串

last_modified

String

参数解释:

最后修改时间

取值范围:

不涉及,格式:yyyy-MM-dd HH:mm:ss

last_modified_timestamp

Long

参数解释:

修改时间时间戳

取值范围:

不涉及,单位:毫秒级

last_change_time

String

参数解释:

最后变更时间

取值范围:

不涉及,格式:yyyy-MM-dd HH:mm:ss

version_uri

String

参数解释:

版本URI

取值范围:

11-34位字母、数字组成的字符串

origin_uri

String

参数解释:

源资源URI

取值范围:

11-34位字母、数字组成的字符串

parent_uri

String

参数解释:

父资源URI

取值范围:

11-34位字母、数字组成的字符串

parent_path

String

参数解释:

父资源路径

取值范围:

长度小于128个字符的字符串

creation_version_uri

String

参数解释:

创建版本URI

取值范围:

11-34位字母、数字组成的字符串

creation_date

String

参数解释:

创建时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

creation_date_timestamp

Long

参数解释:

创建时间时间戳

取值范围:

不涉及,单位:毫秒级

author_name

String

参数解释:

创建人名称

取值范围:

长度小于128个字符的字符串

comment

String

参数解释:

备注

取值范围:

长度小于1024个字符的字符串

number

String

参数解释:

编号

取值范围:

长度小于128个字符的字符串

is_master

Integer

参数解释:

是否为Master分支

取值范围:

  • 0:非Master分支

  • 1:Master分支

is_iterator

Integer

参数解释:

是否为迭代

取值范围:

  • 0:非迭代

  • 1:迭代

plan_start_date

String

参数解释:

开始时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

plan_end_date

String

参数解释:

结束时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

service_id

String

参数解释:

微服务ID

取值范围:

长度小于128个字符的字符串

service_name

String

参数解释:

微服务名

取值范围:

长度小于128个字符的字符串

pbi_id

String

参数解释:

PBI ID

取值范围:

长度小于128个字符的字符串

pbi_name

String

参数解释:

PBI信息

取值范围:

长度小于128个字符的字符串

plan_id

String

参数解释:

计划ID

取值范围:

11-34位字母和数字组成的字符串

metric_pbi_ids

String

参数解释:

度量PBI ID

取值范围:

长度小于128个字符的字符串

metric_pbi_id_names

String

参数解释:

度量PBI名称

取值范围:

长度小于128个字符的字符串

last_syn_date

String

参数解释:

最后同步时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

is_closed

String

参数解释:

版本是否关闭

取值范围:

不涉及

asyn_git

String

参数解释:

是否同步git库

取值范围:

不涉及

schema_no

Integer

参数解释:

schema编号

取值范围:

1-10

finish_date

String

参数解释:

迭代实际完成时间

取值范围:

时间格式为"yyyy-MM-dd HH:mm:ss"

owner_name

String

参数解释:

处理者名称

取值范围:

长度小于128个字符的字符串

creator_name

String

参数解释:

创建人名称

取值范围:

长度小于128个字符的字符串

current_stage

String

参数解释:

当前所处阶段

取值范围:

  • create:创建阶段

  • strategy:策略阶段

  • design:设计阶段

  • execute:执行阶段

  • report:报告阶段

service_types

Array of integers

参数解释:

服务类型集合,数组内每个integer值代表的服务类型含义:-1表示全量用例,0表示手工测试,1表示接口自动化,7表示功能自动化,8表示WebUI自动化,100表示自定义自动化(工厂),11表示性能自动化

取值范围:

不涉及

risk_rating

Integer

参数解释:

风险等级

取值范围:

  • 0:无风险

  • 1:低风险

  • 2:较低风险

  • 3:中等风险

  • 4:较高风险

  • 5:极高风险

risk_des

String

参数解释:

风险描述

取值范围:

最大长度500位字符

project_uuid

String

参数解释:

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

取值范围:

32位字母和数字组成的字符串

domain_id

String

参数解释:

租户ID

取值范围:

11-34位字母和数字组成的字符串

pi_id

String

参数解释:

pi的id

取值范围:

不涉及

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

查询工作项相关联测试计划

GET https://{endpoint}/v4/{project_id}/workitem/{workitem_id}/iterators

{
  "project_id" : "098ad17656684cc5a49a4f7007517f95",
  "workitem_id" : "WI001"
}

响应示例

状态码:200

{
  "value" : [ {
    "uri" : "iterator-001",
    "name" : "版本1.0",
    "description" : "第一个测试版本"
  }, {
    "uri" : "iterator-002",
    "name" : "版本2.0",
    "description" : "第二个测试版本"
  } ]
}

状态码:400

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码:500

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码

状态码

描述

200

OK

400

Bad Request

500

Internal Server Error

错误码

请参见错误码。

相关文档