文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试用例管理/ 根据用例URI集合，返回未在该迭代下用例列表（用例名+用例uri+编号） - ShowIteratorTestCasesNotInIterator
更新时间：2026-06-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

根据用例URI集合，返回未在该迭代下用例列表（用例名+用例uri+编号） - ShowIteratorTestCasesNotInIterator

功能介绍

此接口根据入参用例URI集合和迭代uri，查询返回返回未在该迭代下用例列表,包含用例名+用例uri+编号

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/iterators/{iterator_uri}/testcases/nonexistent

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

iterator_uri

是

String

迭代uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

case_uris

是

Array of strings

用例URI集合

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

value

Array of TestCaseVo objects

请求返回的数据
表4 TestCaseVo

参数

参数类型

描述

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_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_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

参数解释

用例标签名称列表

取值范围

不涉及

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

取值范围

长度等于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

取值范围

不涉及

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

/v4/db9851fc9d09438c8577f90fd7915ade/iterators/v92t00010g2edrt1/testcases/nonexistent

{
  "case_uris" : [ "001rv9521lf1" ]
}

响应示例

状态码：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-19T08:37:15.425Z",
    "last_modified_timestamp" : 1660617231016,
    "last_change_time" : "2025-06-19T08:37:15.425Z",
    "version_uri" : "001s16gt68e",
    "origin_uri" : "001rv5i9u14",
    "parent_uri" : "001s16gt68e",
    "parent_path" : "/b6c4288728234a2e804b6df9465d7b5b/001s16gt68e",
    "creation_version_uri" : "001s16gt68e",
    "creation_date" : "2025-06-19T08:37:15.425Z",
    "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-19T08:37:15.425Z",
    "detect_type" : "15",
    "execute_param" : "6",
    "test_feature" : "市场",
    "is_contract_testcase" : 1,
    "time_cost" : 5000,
    "be_auto_type_time" : "2025-06-19T08:37:15.425Z",
    "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-19T08:37:15.425Z",
    "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

错误码

请参见错误码。

父主题： 测试用例管理

相关文档