# 查询单个测试计划下的需求列表 - ShowIteratorIssues
#### 功能介绍
此接口用于查询单个测试计划下的需求列表,同页面 测试 -\> 测试计划 -\> 点击测试计划 -\> 页签中点击需求 -\> 查询需求列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v4/testhub/projects/{project_id}/iterators/{iterator_uri}/issues
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                 |
|:---|:---|:---|:---|
| project_id   | 是    | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| iterator_uri | 是    | String | 计划uri                                                                                                              |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述   |
|:---|:---|:---|:---|
| offset | 是    | Integer | 当前页数 |
| limit  | 是    | Integer | 每页条数 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数       | 参数类型                                                                                      | 描述                                   |
|:---|:---|:---|
| \[数组元素\] | Array of [ExternalTestIssueVo] objects | status为failed时，存放只有reason的ApiError对象 |
   
 表4ExternalTestIssueVo 
| 参数           | 参数类型                                                                        | 描述                                                                                                                 |
|:---|:---|:---|
| name         | String                                                                      | 名称                                                                                                                 |
| owner        | [NameAndIdVo] object             | 处理者信息                                                                                                              |
| severity     | [NameAndIdVo] object             | 工作项的重要程度                                                                                                           |
| status       | [NameAndIdVo] object             | 工作项的状态                                                                                                             |
| tracker      | [NameAndIdVo] object             | 工作项的类型                                                                                                             |
| iteration    | [NameAndIdVo] object             | 工作项的迭代信息                                                                                                           |
| module       | [NamePathAndPathVo] object | 工作项的模块信息                                                                                                           |
| project_id   | String                                                                      | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| plan_id      | String                                                                      | 计划id                                                                                                               |
| workitem_id  | String                                                                      | 需求项id                                                                                                              |
| parent_issue | String                                                                      | 父项                                                                                                                 |
| start_date   | String                                                                      | 开始日期                                                                                                               |
| end_date     | String                                                                      | 结束日期                                                                                                               |
| region_id    | String                                                                      | 局点id                                                                                                               |
   
 表5NameAndIdVo 
| 参数   | 参数类型   | 描述                                                                                                                                         |
|:---|:---|:---|
| id   | String | **参数解释** ID **取值范围** 不涉及 |
| name | String | **参数解释** 名称 **取值范围** 不涉及 |
   
 表6NamePathAndPathVo 
| 参数        | 参数类型   | 描述     |
|:---|:---|:---|
| id        | String | ID     |
| name      | String | 名称     |
| path      | String | 路径id   |
| path_name | String | 模块路径名称 |
   
**状态码：400**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：401**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：404**
表9响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：500**
表10响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
#### 请求示例
```
/v4/testhub/projects/{project_id}/iterators/{iterator_uri}/issues?offset=1&limit=10
```
#### 响应示例
**状态码：200**
OK
```
[ {
  "owner" : {
    "name" : "wangluodan1",
    "id" : "a17801c5d15f46e28112eec8a880683d"
  },
  "severity" : { },
  "end_date" : "",
  "parent_issue" : "",
  "module" : { },
  "region_id" : "roma-guian-2",
  "project_id" : "1b7179edc79a431f9711434124ac9f28",
  "workitem_id" : "1185878603530375169",
  "name" : "IR002",
  "tracker" : {
    "name" : "IR",
    "id" : "7"
  },
  "iteration" : { },
  "plan_id" : "v90200010s4auo7d",
  "status" : {
    "name" : "初始",
    "id" : "13"
  },
  "start_date" : ""
} ]
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。