# 获取用例历史执行数据 - ListDebugCases #### 功能介绍 根据查询参数获取用例历史执行数据 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v2/casehistory 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | testServiceId | 是 | String | **参数解释** 项目唯一标识 **约束限制** 不涉及 **取值范围** 32个字符组成的字符串 **默认取值** 不涉及 **获取方法** 进入项目，地址栏获取testServiceId | | taskId | 否 | String | **参数解释** 任务唯一标识 **约束限制** 不涉及 **取值范围** 32个字符组成的字符串 **默认取值** 不涉及 **获取方法** 从接口POST /v2/casehistory请求query中获取taskId对应的值 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | ListDebugCasesRequestBody | 是 | String | 查询获取用例历史执行数据请求体 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [CommonResponseErrorOfobject] object | **参数解释** 统一错误返回 **取值范围** 不涉及 | | result | [QueryCasesResponseV2] object | **参数解释** 结果 **取值范围** 不涉及 | | status | String | **参数解释** 请求结果状态 **取值范围** - success, 查询计费信息成功 - error, 查询计费信息失败 3-128个字符组成的字符串 | 表5CommonResponseErrorOfobject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释** 接口调用失败错误码 **取值范围** 不超过256个字符组成的字符串 | | reason | String | **参数解释** 接口调用失败原因 **取值范围** 不超过1000个字符组成的字符串 | 表6QueryCasesResponseV2 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | caseResultList | Array of [CaseHistoryResult] objects | 历史结果列表 | | pageNo | Integer | 分页起始下标 | | totalCount | Integer | 用例总数量 | | totalPage | Integer | 用例总页数 | 表7CaseHistoryResult | 参数 | 参数类型 | 描述 | |:---|:---|:---| | author | String | 处理人 | | authorid | String | 处理人唯一标识 | | caseName | String | 用例名称 | | endTime | String | 结束时间 | | failureCause | String | 失败原因 | | id | String | 主键ID | | log | String | 日志 | | num | Integer | 顺序 | | number | String | 用例唯一标识 | | planId | String | 计划唯一标识 | | releaseversion | String | 版本号 | | result | String | **参数解释** 结果 **取值范围** 不涉及 | | startTime | String | 开始时间 | | status | String | **参数解释** 请求结果状态 **取值范围** - success, 查询计费信息成功 - error, 查询计费信息失败 3-128个字符组成的字符串 | | taskId | String | 任务唯一标识 | | taskName | String | 任务名称 | | testServiceId | String | 工程唯一标识 | **状态码：201** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [CommonResponseErrorOfobject] object | **参数解释** 统一错误返回 **取值范围** 不涉及 | | result | [QueryCasesResponseV2] object | **参数解释** 结果 **取值范围** 不涉及 | | status | String | **参数解释** 请求结果状态 **取值范围** - success, 查询计费信息成功 - error, 查询计费信息失败 3-128个字符组成的字符串 | 表9CommonResponseErrorOfobject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释** 接口调用失败错误码 **取值范围** 不超过256个字符组成的字符串 | | reason | String | **参数解释** 接口调用失败原因 **取值范围** 不超过1000个字符组成的字符串 | 表10QueryCasesResponseV2 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | caseResultList | Array of [CaseHistoryResult] objects | 历史结果列表 | | pageNo | Integer | 分页起始下标 | | totalCount | Integer | 用例总数量 | | totalPage | Integer | 用例总页数 | 表11CaseHistoryResult | 参数 | 参数类型 | 描述 | |:---|:---|:---| | author | String | 处理人 | | authorid | String | 处理人唯一标识 | | caseName | String | 用例名称 | | endTime | String | 结束时间 | | failureCause | String | 失败原因 | | id | String | 主键ID | | log | String | 日志 | | num | Integer | 顺序 | | number | String | 用例唯一标识 | | planId | String | 计划唯一标识 | | releaseversion | String | 版本号 | | result | String | **参数解释** 结果 **取值范围** 不涉及 | | startTime | String | 开始时间 | | status | String | **参数解释** 请求结果状态 **取值范围** - success, 查询计费信息成功 - error, 查询计费信息失败 3-128个字符组成的字符串 | | taskId | String | 任务唯一标识 | | taskName | String | 任务名称 | | testServiceId | String | 工程唯一标识 | **状态码：401** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | **状态码：403** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | **状态码：404** 表14响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | #### 请求示例 ``` post https://{endpoint}/v2/casehistory?testServiceId=afd8fc0bc3d74f5f9a99a46321b8e20b "{ "caseId": "v92t00010i80vhsp", "testServiceId": "afd8fc0bc3d74f5f9a99a46321b8e20b", "pageNum": 1, "pageSize": 5 }" ``` #### 响应示例 **状态码：200** 根据测试套唯一标识查询所有用例数据成功 ``` { "status" : "success", "result" : { "totalCount" : 1, "totalPage" : 1, "pageNo" : 1, "caseResultList" : [ { "taskId" : "df19c643fc38441c90de90578c2c33a3", "testServiceId" : "afd8fc0bc3d74f5f9a99a46321b8e20b", "taskName" : "taskTestSuite2022/8/23 11:33:40", "number" : "v92t00010i80vhsp", "caseName" : "TC_igd4AmSX", "startTime" : "2025-06-17 15:27:31 957", "author" : "CloudTest-0704", "endTime" : null, "result" : "5", "status" : "Running", "log" : "00:00:00.405", "failureCause" : null, "num" : 1, "id" : "0f6749c7-43f2-4e7c-a4c5-55d0c884102b", "releaseversion" : null, "authorid" : "fdc93bccd8d040778701d4d35a4a4313", "planId" : "" } ] }, "error" : null } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 根据测试套唯一标识查询所有用例数据成功 | | 201 | Created | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。