# 根据节点Ids获取所有关联的用例对象 - ShowTestCasesByNodeIds #### 功能介绍 根据脑图节点Id列表获取所有关联的用例对象 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v2/{project_id}/testcases/node-id 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目的32位uuid，项目唯一标识，通过[获取CodeArts项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4005.html)接口查询项目列表获取。 **取值范围：** 字符串长度32。 **默认取值：** 无。 | #### 请求参数 表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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | params | 是 | [ShowTestCasesByNodeIdsParam] object | **参数解释：** 用例分页参数 | 表4ShowTestCasesByNodeIdsParam | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 是 | Integer | **参数解释：** 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 | | limit | 是 | Integer | **参数解释：** 每页显示的条目数量，最大支持100条 | | mindmap_id | 是 | String | **参数解释：** 脑图ID **取值范围：** 大小写字母、数字。 长度限制固定32位 **默认取值：** 无 **获取方法：** 点击进入目标脑图，复制地址栏中的mindId=xxxxx，等号后为id。 | | node_id_collection | 是 | Array of strings | **参数解释：** 节点ID集合 | | is_archive | 否 | Boolean | **参数解释：** 是否归档 **取值范围：** - 0，表示未归档。 - 1，表示已归档。 | #### 响应参数 **状态码：200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释：** 错误码 **取值范围：** 大小写字母、数字。 长度限制0到20位 | | data | [BasePageInfoTestCase] object | **参数解释：** 返回体 **取值范围：** 不涉及 | | message | String | **参数解释：** 错误信息 **取值范围：** 大小写字母、数字、符号、中文。 长度限制0到1000位 | 表6BasePageInfoTestCase | 参数 | 参数类型 | 描述 | |:---|:---|:---| | limit | Integer | **参数解释：** 每页显示的条目数量，最大支持100条 **取值范围：** 数字，范围1到100。 | | list | Array of [TestCase] objects | **参数解释：** 返回体 **取值范围：** 不涉及 | | offset | Integer | **参数解释：** 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 **取值范围：** 数字，范围0-100000。 | | pages | Integer | **参数解释：** 总页数量 **取值范围：** 数字，范围1-100。 | | size | Integer | **参数解释：** 列表个数 **取值范围：** 数字，范围1-200。 | | total | Long | **参数解释：** 总数 **取值范围：** 数字。 | 表7TestCase | 参数 | 参数类型 | 描述 | |:---|:---|:---| | auto_type | String | **参数解释：** 自动化类型 **取值范围：** 大小写字母、数字、符号。 | | case_design_desc | String | **参数解释：** 用例设计描述 **取值范围：** 大小写字母、数字、符号、中文。 | | case_name | String | **参数解释：** 用例名称 **取值范围：** 大小写字母、数字、符号、中文。 长度限制1-10000位 | | case_num | String | **参数解释：** 用例编号 **取值范围：** 大小写字母、数字、符号。 | | create_time | String | **参数解释：** 创建时间 **取值范围：** 固定日期格式yyyy-MM-dd HH:mm:ss | | creator_name | String | **参数解释：** 创建人名字 **取值范围：** 大小写字母、数字、符号、中文。 | | creator_num | String | **参数解释：** 创建者，用户在IAM中的ID。 **取值范围：** 大小写字母、数字。 长度限制固定32位 | | deleted | String | **参数解释：** 删除状态 **取值范围：** 大小写字母、数字、符号、中文。 | | expected_results | String | **参数解释：** 预期结果 **取值范围：** 大小写字母、数字、符号、中文。 | | extra_param | String | **参数解释：** 额外模板字段：以json形式存储，前台解析 **取值范围：** 大小写字母、数字、符号、中文。 | | factor_combination_json | String | **参数解释：** 因子组合json **取值范围：** 大小写字母、数字、符号、中文。 | | operation_and_expected_result | String | **参数解释：** 操作及预期结果 **取值范围：** 大小写字母、数字、符号、中文。 | | id | String | **参数解释：** id 主键 **取值范围：** 大小写字母、数字。 长度限制固定32位 | | is_archive | Boolean | **参数解释：** 是否归档 **取值范围：** - 0，表示未归档。 - 1，表示已归档。 | | mindmap_id | String | **参数解释：** 脑图ID **取值范围：** 大小写字母、数字。 长度限制固定32位 | | node_id | String | **参数解释：** 节点ID **取值范围：** 大小写字母、数字。 长度限制固定32位 | | batch_id | String | **参数解释：** 批次id **取值范围：** 大小写字母、数字。 长度限制固定32位 | | branch_id | String | **参数解释：** 分支ID **取值范围：** 大小写字母、数字。 | | plan_id | String | **参数解释：** 计划ID **取值范围：** 大小写字母、数字。 长度限制固定32位 | | prerequisite | String | **参数解释：** 用例前置步骤 **取值范围：** 大小写字母、数字、符号、中文。 | | test_case_level | String | **参数解释：** 测试用例级别 **取值范围：** 大小写字母、数字、符号、中文。 | | test_procedure | String | **参数解释：** 测试步骤 **取值范围：** 大小写字母、数字、符号、中文。 | | update_name | String | **参数解释：** 更新人名字 **取值范围：** 大小写字母、数字、符号、中文。 | | update_num | String | **参数解释：** 更新人工号 **取值范围：** 大小写字母、数字。 | | update_time | String | **参数解释：** 更新时间 **取值范围：** 固定日期格式yyyy-MM-dd HH:mm:ss | | url | String | **参数解释：** url | | uri | String | **参数解释：** uri **取值范围：** 大小写字母、数字、符号。 | | project_id | String | **参数解释：** 项目ID **取值范围：** 大小写字母、数字。 长度限制固定32位 | | service_id | String | **参数解释：** 服务id **取值范围：** 大小写字母、数字。 长度限制固定32位 | **状态码：201** Created #### 请求示例 根据节点Ids获取所有关联的用例对象 ``` post https://{endpoint}/v2/f70d0db4745c435aa7cd3dd81d8818e7/testcases/node-id { "params" : { "is_archive" : true, "mindmap_id" : "e581c00a1ead42d0b3bc1abb77fbbceb", "node_id_collection" : [ ], "offset" : 1, "limit" : 10 } } ``` #### 响应示例 **状态码：200** OK ``` { "code" : "success", "data" : { "total" : 1, "list" : [ { "id" : "90FB499CE2BD469CA400A3A850FC2B9C", "prerequisite" : "", "url" : null, "uri" : "v92u000105orl1l3", "deleted" : "no", "create_time" : "2025/01/13 14:55:27 GMT+08:00", "creator_name" : "user", "creator_num" : "efdb403066474ab08836b9eeaaa23bca", "update_name" : "user", "update_num" : "efdb403066474ab08836b9eeaaa23bca", "update_time" : "2025/01/13 14:55:35 GMT+08:00", "case_name" : "子主题", "test_procedure" : "", "expected_results" : "", "operation_and_expected_result" : null, "case_design_desc" : null, "case_num" : null, "auto_type" : "true", "test_case_level" : "2", "node_id" : "7B3E87D771504220A2B9C757E6AC42E1", "mindmap_id" : "fb6bd82a6c084fdab0d8e5d8f820eabc", "is_archive" : true, "extra_param" : "{\"tcStatus\":\"archive\"}", "project_id" : "76667cb543a14cacac2ade913ca44a47", "factor_combination_json" : null, "batch_id" : null, "service_id" : "0", "branch_id" : "v92s0001044h0a6b", "plan_id" : "" } ], "offset" : 1, "limit" : 50, "pages" : 1, "size" : 1 }, "message" : null } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 201 | Created | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。