文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试计划管理/ 查询缺陷相关联测试计划(2.0) - ShowIteratorByDefectV4
更新时间:2026-06-12 GMT+08:00
分享

查询缺陷相关联测试计划(2.0) - ShowIteratorByDefectV4

功能介绍

查询缺陷相关联测试计划,2.0版本接口 当前接口只支持查询 通过接口 POST /v4/{project_id}/defects/{defect_id}/association 操作的关联信息,如果需要查询用例与问题单关联的记录,需要调接口 POST v4/{project_uuid}//workitem/{defect_id}/iterators

调用方法

请参见如何调用API

URI

GET /v4/{project_id}/defects/{defect_id}/iterators

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

字符串类型,长度32位字符

取值范围:

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值:

不涉及

defect_id

String

参数解释

缺陷id

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

获取方法

从req系统获取

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

value

TestVersionVo object

参数解释

版本资源信息

取值范围

不涉及

表4 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|1

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

参数解释:

服务类型

取值范围:

不涉及

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

表5 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:401

表6 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:404

表7 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:500

表8 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

请求示例

响应示例

状态码:200

OK

{
  "value" : {
    "uri" : "v902000113rh3snv",
    "type" : "TestVersion",
    "author" : "a17801c5d15f46e28112eec8a880683d",
    "name" : "ApiTest_测试计划_0001",
    "version" : "v901000113rh3rud",
    "owner" : "a17801c5d15f46e28112eec8a880683d",
    "iterations" : "[]",
    "description" : "description",
    "region" : "roma-guian-2",
    "last_modifier" : "a17801c5d15f46e28112eec8a880683d",
    "last_modified" : "2026-01-22 11:41:54",
    "last_change_time" : "2026-01-22 11:41:54",
    "version_uri" : "v901000113rh3rud",
    "parent_uri" : "v901000113rh3rud",
    "parent_path" : "/d661a38f1d1848789095fb26dd557e9c/v901000113rh3rud/",
    "creation_version_uri" : "v901000113rh3rud",
    "creation_date" : "2026-01-22 11:41:54",
    "author_name" : "wangluodan",
    "is_master" : 0,
    "is_iterator" : 1,
    "plan_start_date" : "2026-01-22 11:38:14",
    "plan_end_date" : "2026-01-22 11:38:14",
    "service_id" : "d661a38f1d1848789095fb26dd557e9c",
    "schema_no" : 10,
    "owner_name" : "wangluodan",
    "current_stage" : "create",
    "service_types" : "[\"0\",\"1\"]",
    "risk_rating" : 0,
    "project_uuid" : "d661a38f1d1848789095fb26dd557e9c",
    "pi_id" : "notSet"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档