
# 查询分支或迭代计划下缺陷列表 - ShowIteratorDefectsFour
#### 功能介绍
此接口用于在项目下查询分支或迭代计划下缺陷列表,同页面 测试 -\> 测试质量看板 -\> 右侧列表页 -\> 缺陷情况
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/{project_id}/versions/{version_uri}/defects/batch-query
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                 |
|:---|:---|:---|:---|
| project_id  | 是    | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| version_uri | 是    | String | 版本uri                                                                                                              |
   
#### 请求参数
表2请求Body参数 
| 参数               | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| own              | 否    | Boolean | 是否是我的                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| case_type        | 否    | String  | 用例类型**参数解释**: 用例类型 **约束限制**: 不涉及 **取值范围**: - 0，手工测试。   - 1，接口自动化。   - 2，性能用例。    **默认取值**: 不涉及 |
| keyword          | 否    | String  | 关键字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| owner_id         | 否    | String  | 所属人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| creator_id       | 否    | String  | 创建人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| status_id        | 否    | String  | 状态id列表                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| serverity_id     | 否    | String  | 服务性id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| page_size        | 是    | Integer | 每页数量                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| page_no          | 是    | Integer | 页码                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| sort_field       | 否    | String  | 排序字段                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| sort_type        | 否    | String  | **参数解释**: 排序类型 **约束限制**: 不涉及 **取值范围**: - ASC，升序。   - DESC，降序。    **默认取值**: 不涉及                                                                                                                                                                    |
| module_id        | 否    | String  | 模块id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| fixed_version_id | 否    | String  | 版本id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数    | 参数类型                                                                   | 描述      |
|:---|:---|:---|
| value | [QueryIssueVo] object | 请求返回的数据 |
   
 表4QueryIssueVo 
| 参数          | 参数类型                                                                                                             | 描述   |
|:---|:---|:---|
| total_count | Integer                                                                                                          | 总数   |
| issue_list  | Array of [QueryIssueAssociatedResultBo] objects | 缺陷列表 |
   
 表5QueryIssueAssociatedResultBo 
| 参数                   | 参数类型   | 描述                                                                                                                 |
|:---|:---|:---|
| workitem_id          | String | 缺陷id                                                                                                               |
| name                 | String | 缺陷名称                                                                                                               |
| tracker_name         | String | 工作项名称                                                                                                              |
| tracker_id           | String | 工作项id                                                                                                              |
| status_name          | String | 状态名                                                                                                                |
| status_id            | String | 状态id                                                                                                               |
| project_uuid         | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| owner                | String | 处理人                                                                                                                |
| creator              | String | 创建者id                                                                                                              |
| severity_name        | String | 重要程度名称                                                                                                             |
| severity_id          | String | 重要程度id                                                                                                             |
| start_date           | String | 预计开始日期                                                                                                             |
| start_date_timestamp | Long   | 预计开始日期时间戳                                                                                                          |
| due_date             | String | 预计结束日期                                                                                                             |
| due_date_timestamp   | Long   | 预计结束日期时间戳                                                                                                          |
| board_id             | String | 板id                                                                                                                |
| board_name           | String | 板名称                                                                                                                |
| sequence_id          | String | xBoard项目工作项序列号                                                                                                     |
   
**状态码：400**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                  |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：401**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                  |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：404**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                  |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：500**
表9响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                  |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
#### 请求示例
查询分支或迭代计划下缺陷列表
```
post https://{endpoint}/v4/3c913532482340e69b9b724f6732c67c/versions/v90200010rvlmvjf/defects/batch-query
{
  "page_no" : 1,
  "page_size" : 10
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : {
    "total_count" : 1,
    "issue_list" : [ {
      "workitem_id" : "1490450",
      "name" : "新建缺陷",
      "tracker_name" : "Bug",
      "tracker_id" : "3",
      "status_name" : "新建",
      "status_id" : "1",
      "project_uuid" : "3c913532482340e69b9b724f6732c67c",
      "owner" : "TMSS001_ShylaChen",
      "creator" : "TMSS001_ShylaChen",
      "severity_name" : "一般",
      "severity_id" : "12",
      "start_date" : "",
      "due_date" : ""
    } ]
  }
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
