# 根据用例URI集合查询用例列表 - ShowTestCaseListByUris #### 功能介绍 此接口用于根据传入的用例编号集合查询用例列表信息,返回对应用例的详情数据 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/testcases 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | case_uris | 否 | Array of strings | 用例URI集合，单次查询支持1\~50个用例uri | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | Array of [TestCaseVo] objects | 实际的数据类型：单个对象，集合 或 NULL | | reason | String | 业务失败的提示内容 | | page_size | Integer | 分页大小 | | page_no | Integer | 分页编码 | | has_more | Boolean | 是否有更多 | 表4TestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | **参数解释** 用例ID **取值范围** 不涉及 | | version_uri | String | **参数解释** 版本URI **取值范围** 不涉及 | | parent_uri | String | **参数解释** 父资源URI **取值范围** 不涉及 | | parent_path | String | **参数解释** 父资源路径 **取值范围** 不涉及 | | type | String | **参数解释** 资源类型 **取值范围** 不涉及 | | creation_version_uri | String | **参数解释** 创建版本URI **取值范围** 不涉及 | | last_modifier | String | **参数解释** 最后修改人 **取值范围** 不涉及 | | last_modified | String | **参数解释** 最后修改时间 **取值范围** yyyy-MM-dd HH:mm:ss | | last_change_time | String | **参数解释** 最后变更时间 **取值范围** yyyy-MM-dd HH:mm:ss | | number | String | **参数解释** 用例编号 **取值范围** 不涉及 | | name | String | **参数解释** 用例名称 **取值范围** 不涉及 | | rank | String | **参数解释** 用例等级 **取值范围** 不涉及 | | case_type | Integer | **参数解释** 用例类型 **取值范围** 不涉及 | | platform_type | Integer | **参数解释** 执行平台类型 **取值范围** 不涉及 | | service_type | Integer | **参数解释** 服务类型 **取值范围** 不涉及 | | test_step | String | **参数解释** 测试步骤 **取值范围** 不涉及 | | expect_output | String | **参数解释** 期望结果 **取值范围** 不涉及 | | auto_type | Integer | **参数解释** 自动化类型 **取值范围** 非自动化:0, 是自动化:1 | | to_be_auto_exec | Integer | **参数解释** 被自动化执行 **取值范围** 不涉及 | | dr_relation_id | String | **参数解释** 工作项id **取值范围** 不涉及 | | automatically_executed | Integer | **参数解释** 是否被自动化执行 **取值范围** 不涉及 | | is_contract_testcase | Integer | **参数解释** 是否是契约用例 **取值范围** 0:表示非契约用例, 1：表示契约用例 | | time_cost | Double | **参数解释** 总共耗时 **取值范围** 不涉及 | | last_exe_author | String | **参数解释** 最后一次执行用户 **取值范围** 不涉及 | | status_code | String | **参数解释** 状态ID **取值范围** 不涉及 | | result_code | String | **参数解释** 结果Code **取值范围** 不涉及 | | status_name | String | **参数解释** 状态名称 **取值范围** 不涉及 | | author | String | **参数解释** 创建人名称 **取值范围** 不涉及 | | author_id | String | **参数解释** 创建人ID **取值范围** 不涉及 | | region | String | **参数解释** 逻辑region **取值范围** 不涉及 | | owner | String | **参数解释** 处理人名称 **取值范围** 不涉及 | | issue_id | String | **参数解释** 工作项id **取值范围** 不涉及 | | issue_tracker_id | String | **参数解释** 工作项类型id **取值范围** 不涉及 | | issue_assign_status | String | **参数解释** 工作项分配状态 **取值范围** 不涉及 | | issue_name | String | **参数解释** 工作项名称 **取值范围** 不涉及 | | issue_design_owner | String | **参数解释** 工作项设计责任人 **取值范围** 不涉及 | | issue_design_owner_d | String | **参数解释** 工作项设计责任人id **取值范围** 不涉及 | | tracker_name | String | **参数解释** 工作项类型名称 **取值范围** 不涉及 | | defect_list | Array of [NameAndIdVo] objects | **参数解释** 缺陷列表 **取值范围** 不涉及 | | result_name | String | **参数解释** 结果名称 **取值范围** 不涉及 | | execute_latest_time | String | **参数解释** 最后执行时间 **取值范围** yyyy-MM-dd HH:mm:ss | | execute_duration | String | **参数解释** 执行时长 **取值范围** 不涉及 | | is_keyword | Integer | **参数解释** 是否关键用例 **取值范围** 不涉及 | | project_uuid | String | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 不涉及 | | test_type | String | **参数解释**: 测试类型 **取值范围**: - 1，功能性测试。 - 2，兼容性测试。 - 4，性能测试。 - 15，易用性测试。 - 22，可靠性测试。 - 14，安全性测试。 - 21，可服务性测试。 | | creation_date | String | **参数解释** 创建时间 **取值范围** 不涉及 | 表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/projects/f3087a82b44744c29a1bd69ab6ada154/testcases { "case_uris" : [ "213123123", "213232323" ] } ``` #### 响应示例 **状态码：200** OK ``` { "value" : [ { "uri" : "12312312", "name" : "新建用例1", "rank" : "1" }, { "uri" : "12312313", "name" : "新建用例2", "rank" : "3" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。