# 查询被迭代引用的用例 - ShowCasesInIterator #### 功能介绍 此接口用于查询测试计划下的用例,传入用例id列表,返回用例信息 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/iterators/{iterator_uri}/testcases/batch-query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | iterator_uri | 是 | String | 迭代uri | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | case_ids | 是 | Array of strings | 用例id | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | Array of [TestCaseVo] objects | 请求返回的数据 | 表4TestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | **参数解释** 用例URI **取值范围** 11-34位字母及数字 | | type | String | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。 - Task，任务。 - TestVersion，分支。 - IteratorTestCase，迭代用例。 | | author | String | **参数解释** 创建人 **取值范围** 长度1-128字符 | | name | String | **参数解释** 名称 **取值范围** 长度1-128字符 | | rank | Integer | **参数解释** 用例等级 **取值范围** - 0，Priority 0。 - 1，Priority 1。 - 2，Priority 2。 - 3，Priority 3。 - 4，Priority 4。 | | preparation | String | **参数解释** 前置条件 **取值范围** 长度1-128字符 | | remark | String | **参数解释** 备注 **取值范围** 长度1-128字符 | | stage | String | **参数解释** 测试阶段 **取值范围** 不涉及 | | activity | String | **参数解释** 测试类型 **取值范围** 长度1-128字符 | | keywords | String | **参数解释** 关键词 **取值范围** 长度1-128字符 | | market | String | **参数解释** apitest标记是否代码已提交 **取值范围** 长度1-128字符 | | designer | String | **参数解释** 设计者 **取值范围** 长度1-128字符 | | tags | String | **参数解释** 标签 **取值范围** 长度1-128字符 | | execute_parameter | String | **参数解释** 执行参数 **取值范围** 长度1-128字符 | | region | String | **参数解释** 逻辑region **取值范围** 长度1-128字符 | | owner | String | **参数解释** 处理人id，IteratorTestCase字段 **取值范围** 长度1-128字符 | | last_modifier | String | **参数解释** 最后修改人 **取值范围** 长度1-128字符 | | last_modified | String | **参数解释** 最后修改时间 **取值范围** 长度1-128字符 | | last_modified_timestamp | Long | **参数解释** 修改时间时间戳 **取值范围** 时间戳格式，单位为毫秒 | | last_change_time | String | **参数解释** 最后变更时间 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss" | | version_uri | String | **参数解释** 版本URI **取值范围** 11-34位字母及数字 | | origin_uri | String | **参数解释** 源资源URI **取值范围** 11-34位字母及数字 | | parent_uri | String | **参数解释** 父资源URI **取值范围** 11-34位字母及数字 | | parent_path | String | **参数解释** 父资源路径 **取值范围** 不涉及 | | creation_version_uri | String | **参数解释** 创建版本URI **取值范围** 11-34位字母及数字 | | creation_date | String | **参数解释** 创建时间 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss" | | creation_date_timestamp | Long | **参数解释** 创建时间时间戳 **取值范围** 时间戳格式，单位为毫秒 | | author_id | String | **参数解释** 创建人ID **取值范围** 不涉及 | | author_name | String | **参数解释** 创建人名称 **取值范围** 长度1-128字符 | | comment | String | **参数解释** 备注 **取值范围** 长度1-128字符 | | number | String | **参数解释** 编号 **取值范围** 长度1-128字符 | | case_type | Integer | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。 - 1，接口自动化。 - 2，性能用例。 | | platform_type | Integer | **参数解释** 执行平台类型 **取值范围** 不涉及 | | service_type | Integer | **参数解释**: 服务类型 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 | | service_type_name | String | **参数解释** 服务类型名称 **取值范围** 长度1-128字符 | | test_type | Integer | **参数解释**: 测试类型 **取值范围**: - 1，性能。 - 2，安全。 - 3，功能。 - 4，韧性可靠性。 - 5，过载场景。 | | test_type_name | String | **参数解释** 测试类型名称 **取值范围** 长度1-128字符 | | design_note | String | **参数解释** 设计描述 **取值范围** 长度1-128字符 | | test_step | String | **参数解释** 测试步骤 **取值范围** 不涉及 | | expect_output | String | **参数解释** 期望结果 **取值范围** 不涉及 | | env_type | String | **参数解释** 测试环境类型 **取值范围** 不涉及 | | exe_platform | String | **参数解释** 执行平台 **取值范围** 不涉及 | | testcase_project | String | **参数解释** 测试工程 **取值范围** 不涉及 | | svn_script_path | String | **参数解释** 脚本路径 **取值范围** 不涉及 | | map_restrict | String | **参数解释** 约束条件 **取值范围** 不涉及 | | network_script_name | String | **参数解释** 网络脚本名 **取值范围** 不涉及 | | auto_type | Integer | **参数解释**: 自动化类型 **取值范围**: - 0，非自动化。 - 1，是自动化。 | | to_be_auto_exec | Integer | **参数解释** 被自动化执行 **取值范围** 不涉及 | | last_result | String | **参数解释** 最后一次结果 **取值范围** 不涉及 | | last_result_uri | String | **参数解释** 最后一次结果Uri **取值范围** 不涉及 | | feature_uri | String | **参数解释** 目录Uri **取值范围** 不涉及 | | feature_name | String | **参数解释** 目录名称 **取值范围** 不涉及 | | interface_name | String | **参数解释** 测试接口名 **取值范围** 不涉及 | | snp_no | String | **参数解释** 网络问题ID **取值范围** 不涉及 | | dr_relation_id | 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 [NameAndId] objects | **参数解释** 缺陷列表 **取值范围** 不涉及 | | result_name | String | **参数解释** 结果名称 **取值范围** 不涉及 | | test_base_num | String | **参数解释** 测试基数 **取值范围** 不涉及 | | automatically_executed | Integer | **参数解释** 是否被自动化执行 **取值范围** 不涉及 | | first_execute_time | String | **参数解释** 第一次执行时间 **取值范围** 不涉及 | | detect_type | String | **参数解释** 检测类型 **取值范围** 不涉及 | | execute_param | String | **参数解释** 执行参数 **取值范围** 不涉及 | | test_feature | String | **参数解释** 分析领域 **取值范围** 不涉及 | | is_contract_testcase | Integer | **参数解释** 是否是契约用例 **取值范围** 0:表示非契约用例, 1：表示契约用例 | | time_cost | Double | **参数解释** 总共耗时 **取值范围** 不涉及 | | be_auto_type_time | String | **参数解释** 记录用例由非自动化变为自动化类型的时间 **取值范围** 不涉及 | | compare_number | String | **参数解释** 配对用例编号 **取值范围** 不涉及 | | scene_flag | String | **参数解释** 场景标识 **取值范围** 不涉及 | | base_flag | String | **参数解释** 场景标识 **取值范围** 不涉及 | | para_validator | String | **参数解释** 区别是否从yaml中生成的用例 **取值范围** 默认false | | knet_node_id | String | **参数解释** knet节点id **取值范围** 不涉及 | | last_exe_author | String | **参数解释** 最后一次执行用户 **取值范围** 不涉及 | | cloud_carrier | String | **参数解释** 运营商 **取值范围** 不涉及 | | market_place | String | **参数解释** 应用市场 **取值范围** 不涉及 | | test_mind_id | String | **参数解释** 脑图id **取值范围** 不涉及 | | test_mind_url | String | **参数解释** 脑图url **取值范围** 不涉及 | | commit_url | String | **参数解释** git提交url **取值范围** 不涉及 | | test_pattern_number | String | **参数解释** 测试模式编号 **取值范围** 不涉及 | | test_factor_number | String | **参数解释** 测试因子编号 **取值范围** 不涉及 | | status_code | String | **参数解释** 状态Code **取值范围** 不涉及 | | result_code | String | **参数解释** 结果Code **取值范围** 不涉及 | | release_id | String | **参数解释** 迭代ID **取值范围** 不涉及 | | label_id | String | **参数解释** 标签ID **取值范围** 不涉及 | | labels | String | **参数解释** 用例标签名称列表 **取值范围** 不涉及 | | status_name | String | **参数解释** 状态名称 **取值范围** 不涉及 | | module_id | String | **参数解释** 模块ID **取值范围** 不涉及 | | module_name | String | **参数解释** 模块名称 **取值范围** 不涉及 | | module_path | String | **参数解释** 模块path **取值范围** 不涉及 | | module_path_name | String | **参数解释** 模块路径名称 **取值范围** 不涉及 | | execute_latest_time | String | **参数解释** 最后执行时间 **取值范围** 格式为yyyy-MM-dd HH:mm:ss | | execute_duration | String | **参数解释** 执行时长，单位（毫秒） **取值范围** 不涉及 | | execute_times | Integer | **参数解释** 执行次数 **取值范围** 不涉及 | | is_keyword | Integer | **参数解释** 是否关键用例 **取值范围** 不涉及 | | release_dev | String | **参数解释** 测试版本号 **取值范围** 不涉及 | | new_created | String | **参数解释** 是否用户新增用例 **取值范围** 不涉及 | | project_uuid | String | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 长度等于32位，包含大小写字母、数字 | | creation_version_name | String | **参数解释** 创建版本名称，原逻辑marshall添加字段 **取值范围** 不涉及 | | feature_path | String | **参数解释** 特性路径，原逻辑marshall添加字段 **取值范围** 不涉及 | | testcase_uri | String | **参数解释** 实体用例Uri，IteratorTestCase字段 **取值范围** 不涉及 | | owner_name | String | **参数解释** 处理人名称 **取值范围** 不涉及 | | iterator_case_uri | String | **参数解释** 迭代用例Uri，IteratorTestCase字段 **取值范围** 不涉及 | | script_link | String | **参数解释** 脚本链接scriptLink **取值范围** 不涉及 | | test_step_model | String | **参数解释** 测试步骤模式 **取值范围** text: 文本模式; table: 表格模式 | | custom_field_1 | String | **参数解释** 自定义字段1 **取值范围** 不涉及 | | custom_field_2 | String | **参数解释** 自定义字段2 **取值范围** 不涉及 | | custom_field_3 | String | **参数解释** 自定义字段3 **取值范围** 不涉及 | | custom_field_4 | String | **参数解释** 自定义字段4 **取值范围** 不涉及 | | custom_field_5 | String | **参数解释** 自定义字段5 **取值范围** 不涉及 | | custom_field_6 | String | **参数解释** 自定义字段6 **取值范围** 不涉及 | | custom_field_7 | String | **参数解释** 自定义字段7 **取值范围** 不涉及 | | custom_field_8 | String | **参数解释** 自定义字段8 **取值范围** 不涉及 | | custom_field_9 | String | **参数解释** 自定义字段9 **取值范围** 不涉及 | | custom_field_10 | String | **参数解释** 自定义字段10 **取值范围** 不涉及 | | custom_field_11 | String | **参数解释** 自定义字段11 **取值范围** 不涉及 | | custom_field_12 | String | **参数解释** 自定义字段12 **取值范围** 不涉及 | | custom_field_13 | String | **参数解释** 自定义字段13 **取值范围** 不涉及 | | custom_field_14 | String | **参数解释** 自定义字段14 **取值范围** 不涉及 | | custom_field_15 | String | **参数解释** 自定义字段15 **取值范围** 不涉及 | | custom_field_16 | String | **参数解释** 自定义字段16 **取值范围** 不涉及 | | custom_field_17 | String | **参数解释** 自定义字段17 **取值范围** 不涉及 | | custom_field_18 | String | **参数解释** 自定义字段18 **取值范围** 不涉及 | | custom_field_19 | String | **参数解释** 自定义字段19 **取值范围** 不涉及 | | custom_field_20 | String | **参数解释** 自定义字段20 **取值范围** 不涉及 | | custom_field_21 | String | **参数解释** 自定义字段21 **取值范围** 不涉及 | | custom_field_22 | String | **参数解释** 自定义字段22 **取值范围** 不涉及 | | custom_field_23 | String | **参数解释** 自定义字段23 **取值范围** 不涉及 | | custom_field_24 | String | **参数解释** 自定义字段24 **取值范围** 不涉及 | | custom_field_25 | String | **参数解释** 自定义字段25 **取值范围** 不涉及 | 表5NameAndId | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**: 对象编号 **取值范围**: 11-34位的字母及数字（字符串） | | 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/{project_id}/iterators/{iterator_uri}/testcases/batch-query { "case_ids" : [ "001rv8jtamo1" ] } ``` #### 响应示例 **状态码：200** OK ``` { "value" : [ { "uri" : "001s16gt6q5", "type" : "TestVersion", "author" : "efdb403066474ab08836b9eeaaa23bca", "name" : "名称", "rank" : 1, "preparation" : "拥有测试权限", "remark" : "3", "stage" : "3", "activity" : "1", "keywords" : "用例", "market" : "1", "designer" : "张三", "tags" : "aa,bb", "execute_parameter" : "{a:123,b:456,c:'edit'}", "region" : "cn-north-7", "owner" : "张三", "last_modifier" : "efdb403066474ab08836b9eeaaa23bca", "last_modified" : "2025-06-19T09:35:17.006Z", "last_modified_timestamp" : 1660617231016, "last_change_time" : "2025-06-19T09:35:17.006Z", "version_uri" : "001s16gt68e", "origin_uri" : "001rv5i9u14", "parent_uri" : "001s16gt68e", "parent_path" : "/b6c4288728234a2e804b6df9465d7b5b/001s16gt68e", "creation_version_uri" : "001s16gt68e", "creation_date" : "2025-06-19T09:35:17.006Z", "creation_date_timestamp" : 1660617231016, "author_name" : "tester", "comment" : "备注", "number" : "编号", "case_type" : 0, "platform_type" : 0, "service_type" : 0, "service_type_name" : "手工测试", "test_type" : 1, "test_type_name" : "功能性测试", "design_note" : "市场", "test_step" : "1、点击自动化测试", "expect_output" : "用例结果为pass", "env_type" : "TestAPI_h8eXDPryNiOsEBGvSG32", "exe_platform" : "apitest", "testcase_project" : "1", "svn_script_path" : "ApiTest/Test(API)_Alpha/src/scripts/user/script.java", "map_restrict" : "api", "network_script_name" : "scripts.runs.CheckTestHomePage.java", "auto_type" : 1, "to_be_auto_exec" : 0, "last_result" : "Unavailable", "last_result_uri" : "001snptba6m1", "feature_uri" : "004sobn0n0t1", "feature_name" : "AAAA", "interface_name" : "DtsInfoByNoPOST", "snp_no" : "DTS999999AAAA9999", "dr_relation_id" : "20830062657;20830062217;DTS999999AAAA9999", "issue_name" : "需求", "test_base_num" : "12", "automatically_executed" : 1, "first_execute_time" : "2025-06-19T09:35:17.006Z", "detect_type" : "15", "execute_param" : "6", "test_feature" : "市场", "is_contract_testcase" : 1, "time_cost" : 5000, "be_auto_type_time" : "2025-06-19T09:35:17.006Z", "compare_number" : "api", "scene_flag" : "Debugging Case", "base_flag" : "true", "para_validator" : "true", "knet_node_id" : "id", "last_exe_author" : "李四", "cloud_carrier" : "市场", "market_place" : "marketplace", "test_mind_id" : "402882e172c12ee60172c1b4642900c99", "test_mind_url" : "string", "commit_url" : "string", "test_pattern_number" : "402882e", "test_factor_number" : "4sfsd82e", "status_code" : "4sfsd82e", "result_code" : "4sfsd82e", "release_id" : "9374510", "label_id" : "46a5dbfd770f445da87b1a50ee37a86b", "labels" : "46a5dbfd770f445da87b1a50ee37a86b", "module_id" : "60ace553eaf7c955f8cf1615", "module_name" : "模块名称", "module_path" : "id1/id2", "module_path_name" : "模块1/模块2", "execute_latest_time" : "2025-06-19T09:35:17.006Z", "execute_duration" : "00:00:09", "execute_times" : 46, "is_keyword" : 1, "release_dev" : "fd89a8d9dce64c54ade3d7fc9d6cd2dd", "new_created" : "1", "project_uuid" : "0000dbab7df44231a72bfa25a1259c73", "creation_version_name" : "111111", "feature_path" : "/00qs9tk745m/00qs9tlpv6r/00ssqnpuji0/", "testcase_uri" : "00ssqnpuji0", "owner_name" : "张三", "iterator_case_uri" : "00qs9tlpv6r", "script_link" : "链接", "test_step_model" : "text", "custom_field_1" : "自定义字段1", "custom_field_2" : "自定义字段2", "custom_field_3" : "自定义字段3", "custom_field_4" : "自定义字段4", "custom_field_5" : "自定义字段5", "custom_field_6" : "自定义字段6", "custom_field_7" : "自定义字段7", "custom_field_8" : "自定义字段8", "custom_field_9" : "自定义字段9", "custom_field_10" : "自定义字段10", "custom_field_11" : "自定义字段11", "custom_field_12" : "自定义字段12", "custom_field_13" : "自定义字段13", "custom_field_14" : "自定义字段14", "custom_field_15" : "自定义字段15", "custom_field_16" : "自定义字段16", "custom_field_17" : "自定义字段17", "custom_field_18" : "自定义字段18", "custom_field_19" : "自定义字段19", "custom_field_20" : "自定义字段20", "custom_field_21" : "自定义字段21", "custom_field_22" : "自定义字段22", "custom_field_23" : "自定义字段23", "custom_field_24" : "自定义字段24", "custom_field_25" : "自定义字段25" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。