
# 查询用户用例关联缺陷的统计信息，限定在指定时间段内的创建用例 - ListUserCaseDefectInfo
#### 功能介绍
此接口用于查询用户用例关联缺陷的统计信息，同页面 测试 -\> 测试用例 -\> 右侧展示用例列表，点击用例进入详情页 -\> 点击缺陷列表，下方展示关联缺陷列表 -\> 点击缺陷标题，跳转缺陷详情页
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/testhub/projects/{project_id}/testcases/defect-info/list-by-creation-time
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                 |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
   
#### 请求参数
表2请求Body参数 
| 参数                          | 是否必选 | 参数类型    | 描述                |
|:---|:---|:---|:---|
| offset                      | 是    | Integer | 起始偏移量，表示从此偏移量开始查询 |
| limit                       | 是    | Integer | 每页显示的条目数量         |
| create_testcase_start_time  | 是    | String  | 用例创建时间段开始         |
| create_testcase_end_time    | 是    | String  | 用例创建时间段截止         |
| associate_defect_start_time | 否    | String  | 用例关联缺陷时间段开始       |
| associate_defect_end_time   | 否    | String  | 用例关联缺陷时间段截止       |
| branch_id                   | 否    | String  | 分支id              |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数     | 参数类型                                                                                            | 描述   |
|:---|:---|:---|
| values | Array of [UserCaseDefectInfoVo] objects | 数组数据 |
| total  | Integer                                                                                         | 总数   |
   
 表4UserCaseDefectInfoVo 
| 参数           | 参数类型                                                                | 描述                                                                                                                                                         |
|:---|:---|:---|
| creator      | [NameAndIdVo] object | **参数解释** 服务类型信息 **取值范围** 不涉及 |
| defect_count | Integer                                                             | 在时间段关联的缺陷数量                                                                                                                                                |
| defect_ids   | Array of strings                                                    | 在时间段关联的缺陷列表                                                                                                                                                |
| testcase_id  | String                                                              | 用例id                                                                                                                                                       |
| branch_id    | String                                                              | 分支id                                                                                                                                                       |
   
 表5NameAndIdVo 
| 参数   | 参数类型   | 描述                                                                                                                                                     |
|:---|:---|:---|
| id   | String | **参数解释** ID **取值范围** 不涉及 |
| name | String | **参数解释** 名称 **取值范围** 不涉及 |
   
**状态码：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/testhub/projects/2e8b14eb90d54b6c9bc4c0b5cde1f449/testcases/defect-info/list-by-creation-time
{
  "offset" : 1,
  "limit" : 1,
  "create_testcase_start_time" : "2019-05-09T10:35:00+08:00",
  "create_testcase_end_time" : "2019-05-09T10:35:00+08:00",
  "associate_defect_start_time" : "2019-05-09T10:35:00+08:00",
  "associate_defect_end_time" : "2019-05-09T10:35:00+08:00",
  "branch_id" : "kjhgfdlkj7654gsf"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "values" : [ {
    "creator" : {
      "id" : "c217c42b8dfb4ac7bff52a87cbaca38c",
      "name" : "昵称"
    },
    "defect_count" : 0,
    "defect_ids" : [ ],
    "testcase_id" : "v90100010q1qdnae",
    "branch_id" : "v90200010ovl7ss9"
  } ],
  "total" : 30076
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
