# 查询工作项相关联测试计划 - QueryIteratorByWorkitem
#### 功能介绍
此接口用于查询工作项相关联的测试计划
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v4/{project_id}/workitem/{workitem_id}/iterators
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                  |
|:---|:---|:---|:---|
| project_id  | 是    | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 |
| workitem_id | 是    | String | **参数解释** 工作项ID                                                           |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数    | 参数类型                                                                               | 描述               |
|:---|:---|:---|
| value | Array of [TestVersionVo] objects | 查询工作项相关联测试计划返回数据 |
   
 表3TestVersionVo 
| 参数                   | 参数类型    | 描述                  |
|:---|:---|:---|
| uri                  | String  | 版本唯一标识              |
| name                 | String  | 版本名称                |
| number               | String  | 版本编号                |
| is_master            | Integer | 是否为Master分支，0-否，1-是 |
| is_iterator          | Integer | 是否为迭代，0-否，1-是       |
| plan_start_date      | String  | 计划开始时间              |
| plan_start_timestamp | Long    | 计划开始时间戳             |
| plan_end_date        | String  | 计划结束时间              |
| plan_end_timestamp   | Long    | 计划结束时间戳             |
| 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  | 迭代实际完成时间            |
| version              | String  | 待测版本号               |
| owner                | String  | 处理者ID               |
| owner_name           | String  | 处理者名称               |
| creator              | String  | 创建人ID               |
| creator_name         | String  | 创建人名称               |
| current_stage        | String  | 当前所处阶段              |
| service_types        | String  | 服务类型                |
| iterations           | String  | 关联迭代                |
| description          | String  | 版本描述                |
| risk_rating          | Integer | 风险等级                |
| risk_des             | String  | 风险描述                |
| project_uuid         | String  | 项目ID                |
| domain_id            | String  | 租户ID                |
| region               | String  | 区域                  |
| 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**
OK
```
{
  "value" : [ {
    "uri" : "iterator-001",
    "name" : "版本1.0",
    "description" : "第一个测试版本"
  }, {
    "uri" : "iterator-002",
    "name" : "版本2.0",
    "description" : "第二个测试版本"
  } ]
}
```
**状态码：400**
Bad Request
```
{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}
```
**状态码：500**
Internal Server Error
```
{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。