华为云用户手册

响应示例 状态码：200 OK { "total" : 5, "value" : [ { "uri" : "v902000108vdtlr9", "sort" : 1, "stage" : 1, "project_uuid" : "90f8dc52eb7b4c47b853c661152ca62d", "task_uri" : "v902000108vdtlnm", "update_time" : "2025-03-04 14:11:55", "updator_name" : "TMSS01", "updator" : "dfc5347b9b16491e942ce55ce7f79dbc", "case_uri" : "v902000108vdtlme", "is_available" : 1, "test_case_name" : "样例功能用例", "test_case_number" : "008", "status_code" : "7", "status_name" : "完成", "result_code" : "1", "result_name" : "失败", "is_keyword" : 0, "rank_id" : 2 }, { "uri" : "v902000109nhgqtv", "sort" : 2, "stage" : 1, "project_uuid" : "90f8dc52eb7b4c47b853c661152ca62d", "task_uri" : "v902000108vdtlnm", "update_time" : "2025-03-04 14:11:51", "updator_name" : "TMSS01", "updator" : "dfc5347b9b16491e942ce55ce7f79dbc", "case_uri" : "v901000109n3a3mt", "is_available" : 1, "test_case_name" : "用例和备注1", "test_case_number" : "108", "status_code" : "7", "status_name" : "完成", "result_code" : "0", "result_name" : "成功", "is_keyword" : 0, "rank_id" : 2 } ], "page_size" : 2, "page_no" : 1 }

URI POST /GT3KServer/v4/{project_id}/tasks/{task_id}/testcases/batch-query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及 task_id 是 String 任务uri

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释 用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 stage 否 Integer 测试用例在任务中的阶段 owners 否 Array of strings 处理人过滤数组 page_no 否 Integer 页码 page_size 否 Integer 页数量 results 否 Array of strings 结果过滤 status 否 Array of strings 状态过滤 version_uri 否 String 分支/迭代uri release_dev 否 String 任务版本过滤条件，影响关联任务的结果查询，查询当前任务版本下的用例最新结果 sort_field 否 String 排序字段 sort_type 否 String 排序方法 feature_uri 否 String 特性目录URI task_result_uri 否 String 测试套结果uri rank_ids 否 Array of integers 用例等级ID集合 key_word 否 String 关键字 issue_id 否 String 需求id associated_issue 否 Boolean 是否关联需求（null：不限，false：未关联，true：已关联） select_all_pages 否 Boolean 是否全选所有页（null：不全选，false：不全选，true：全选），用于任务批量执行结果功能，只返回用例uri，不返回其他信息 is_available 否 Boolean 用例是否可用 is_script_exist 否 Boolean 用例脚本字段是否有值

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value Array of TaskAssignCaseDetailVo objects 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表5 TaskAssignCaseDetailVo 参数 参数类型 描述 uri String 关联关系uri sort Integer 排序顺序 owner String 责任人id stage Integer 测试阶段 project_uuid String 项目id task_uri String 任务uri update_time String 更新时间 updator_name String 更新人 updator String 更新人id case_uri String 用例uri is_available Integer 是否可用 test_case_name String 用例名称 feature_uri String 用例目录Uri test_case_number String 用例编号 svn_script_path String 脚本路径 status_code String 状态 status_name String 状态名称 result_code String 结果id result_name String 结果名称 owner_name String 责任人名称 execute_latest_time String 最新执行时间 execute_duration String 执行时长 is_keyword Integer 是否是关键用例 net_work_script_name String 脚本名称 rank_id Integer 用例等级 状态码：400 表6 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：401 表7 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：404 表8 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：500 表9 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及

请求示例 POST https://{endpoint}/GT3KServer/v4/features/{feature_id}/children { "project_uuid" : "b318f1f3fcef44dd8d549c3624ea8955", "version_uri" : "v90j0001004q3pfj", "contain_total" : true, "sort_type" : "asc" }

响应示例 状态码：200 OK { "result" : { "value" : [ { "uri" : "v90100010b7rs990", "type" : "TestItem", "author" : "85f7cd3cd8784307a5bb194321bef3c1", "name" : "新增子目录(1)", "last_modifier" : "85f7cd3cd8784307a5bb194321bef3c1", "last_modified" : "2025-03-22 14:08:27", "last_modified_timestamp" : 1742623707424, "last_change_time" : "2025-03-22 14:08:27", "version_uri" : "v901000106dij34m", "parent_uri" : "v901000107pbs1bc", "parent_path" : "/761e569574894180b3ecadc9d9df52b6/v901000106dij34m/v901000107pbs1bc/", "creation_version_uri" : "v901000106dij34m", "creation_date" : "2025-03-22 14:08:27", "creation_date_timestamp" : 1742623707424, "is_feature" : "0", "relate_htsm" : "0", "project_uuid" : "761e569574894180b3ecadc9d9df52b6", "case_total" : 1, "execd_total" : 0, "is_direct_relation" : true, "has_child" : false } ] } }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueListTestItemVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址。 表5 ResultValueListTestItemVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value Array of TestItemVo objects 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表6 TestItemVo 参数 参数类型 描述 uri String 资源URI type String 资源类型 author String 创建人 name String 名称 rank Integer 级别 owner String 责任人 frequence String frequence值 region String 区域 last_modifier String 最后修改人 last_modified String 最后修改时间 last_modified_timestamp Long 修改时间时间戳 last_change_time String 最后变更时间 version_uri String 版本URI origin_uri String 源资源URI parent_uri String 父资源URI parent_path String 父资源路径 creation_version_uri String 创建版本URI creation_date String 创建时间 creation_date_timestamp Long 创建时间时间戳 author_name String 创建人名称 comment String 备注 number String 编号 is_feature String 是否特性 relate_htsm String 是否关联特性 aw_unique_id String aw id test_mind_id String 脑图id test_mind_url String 脑图url project_uuid String 项目id case_total Integer 用例总数 execd_total Integer 执行总数 is_direct_relation Boolean is_direct_relation has_child Boolean 是否有子特性 表7 ApiError 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：400 表8 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：401 表9 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：404 表10 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：500 表11 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 owner 否 String 责任人 stage 否 String 阶段 activity 否 String 活动 version_uri 否 String 版本URI task_uri 否 String 任务uri service_type 否 String 用例服务类型 contain_total 否 Boolean 是否包含用例数 project_uuid 否 String 项目id sort_type 否 String 排序类型 page_number 否 Integer 页码 page_size 否 Integer 每页数量

响应参数 状态码：200 表2 响应Body参数 参数 参数类型 描述 status String success|error; ok|failed result ResultValueTestItemVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址 表3 ResultValueTestItemVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value TestItemVo object 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表4 TestItemVo 参数 参数类型 描述 uri String 资源URI type String 资源类型 author String 创建人 name String 名称 rank Integer 级别 owner String 责任人 frequence String frequence值 region String 区域 last_modifier String 最后修改人 last_modified String 最后修改时间 last_modified_timestamp Long 修改时间时间戳 last_change_time String 最后变更时间 version_uri String 版本URI origin_uri String 源资源URI parent_uri String 父资源URI parent_path String 父资源路径 creation_version_uri String 创建版本URI creation_date String 创建时间 creation_date_timestamp Long 创建时间时间戳 author_name String 创建人名称 comment String 备注 number String 编号 is_feature String 是否特性 relate_htsm String 是否关联特性 aw_unique_id String aw id test_mind_id String 脑图id test_mind_url String 脑图url project_uuid String 项目id case_total Integer 用例总数 execd_total Integer 执行总数 is_direct_relation Boolean is_direct_relation has_child Boolean 是否有子特性 表5 ApiError 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason 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}/GT3KServer/v4/features { "name" : "新增子目录(3)", "version_uri" : "v9080000v2teq999", "parent_uri" : "v9080000v2teq999", "project_uuid" : "ffecfceca51d419cbfc2a28e90c93761", "number" : "" }

响应示例 状态码：200 OK { "status" : "success", "result" : { "value" : { "uri" : "v92u000108e45gkt", "type" : "TestItem", "author" : "afd0d050cc2a4d9eb13bd2c71904c1a2", "name" : "新增子目录(3)", "region" : "cn-north-7", "last_modifier" : "afd0d050cc2a4d9eb13bd2c71904c1a2", "last_modified" : "2025-02-15 17:41:39", "last_modified_timestamp" : 1739612499614, "last_change_time" : "2025-02-15 17:41:39", "version_uri" : "v9080000v2teq999", "parent_uri" : "v9080000v2teq999", "parent_path" : "/ffecfceca51d419cbfc2a28e90c93761/v9080000v2teq999/", "creation_version_uri" : "v9080000v2teq999", "creation_date" : "2025-02-15 17:41:39", "creation_date_timestamp" : 1739612499614, "relate_htsm" : "0", "project_uuid" : "ffecfceca51d419cbfc2a28e90c93761", "case_total" : 0, "execd_total" : 0, "is_direct_relation" : false, "has_child" : false } } }

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 comment 否 String 备注 name 是 String 名称 number 否 String 编号 owner 否 String 责任人 is_feature 否 String 是否为特性,1:特性 2:目录 project_uuid 否 String 项目uuid parent_uri 否 String 父节点uri version_uri 否 String 版本URI ignore_duplicate_name 否 Boolean 是否忽略名称重复

响应示例 状态码：200 OK { "value" : [ { "uri" : "v90b000109n4ldea", "name" : "用例别名", "type" : "text", "description" : "", "creator" : "dfc5347b9b16491e942ce55ce7f79dbc", "custom_field_id" : 3, "custom_field_name" : "customField3", "custom_field_param" : "custom_field_3", "type_name" : "单行文本", "create_time" : "2025-03-03 15:59:12", "create_time_timestamp" : 1740988752000, "project_uuid" : "90f8dc52eb7b4c47b853c661152ca62d" } ] }

URI GET /GT3KServer/v4/{project_id}/testcase/field/batch-query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 value Array of ProjectTestCaseFieldVo objects 本次查询的记录结果 表4 ProjectTestCaseFieldVo 参数 参数类型 描述 uri String 项目用例自定义字段主键 name String 项目用例自定义字段名称 type String 项目用例自定义字段类型（单行文本text、多行文本textArea、单选框radio、多选框checkBox、日期date、数字number、单选用户user） options String 项目用例自定义字段选项（数字类型时，数组两个值，第一个是最小值，第二个是最大值） description String 项目用例自定义字段描述 creator String 项目用例自定义字段创建人 updater String 项目用例自定义字段更新人 custom_field_id Integer 项目用例自定义字段id（1-25数字） custom_field_name String 项目用例自定义字段名称 custom_field_param String 项目用例自定义字段入参或者返回参数名称 type_name String 项目用例自定义字段类型国际化名称 create_time String 项目用例自定义字段创建时间 create_time_timestamp Long 项目用例自定义字段创建时间时间戳 update_time String 项目用例自定义字段更新时间 update_time_timestamp Long 项目用例自定义字段更新时间时间戳 project_uuid String 项目id 状态码：400 表5 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：401 表6 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：404 表7 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：500 表8 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及

请求示例 设置测试套结果 post https://{endpoint}/v4/30649eb093c2479d92c74c75d36ef280/tasks/v91i0000vq98sv3v/results { "result_code" : "0", "description" : "", "test_result_uri" : "v9200000vrnjebem", "release_dev" : null }

响应示例 状态码：200 OK { "status" : "success", "result" : { "value" : { "uri" : "v9200000vrnjebem", "description" : "", "creator" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "updator" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "task_uri" : "v91i0000vq98sv3v", "version_uri" : "v91i0000vq98suq1", "create_time" : "2024-09-10 20:37:44", "update_time" : "2024-09-10 20:37:44", "start_time" : "2024-09-10 20:37:44", "end_time" : "2024-09-10 20:37:44", "result_code" : 0, "finish_flg" : 1, "project_uuid" : "30649eb093c2479d92c74c75d36ef280" } } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 description 否 String 描述 release_dev 否 String 发布版本号 result_code 否 String 结果Code test_result_uri 否 String 任务执行结果Uri status_code 否 String 状态Code version_uri 否 String 分支/迭代uri

URI POST /v4/{project_id}/tasks/{task_uri}/results 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及 task_uri 是 String 任务uri

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status String success|error; result ResultValueTaskResultVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址 表5 ResultValueTaskResultVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value TaskResultVo object 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表6 TaskResultVo 参数 参数类型 描述 uri String URI name String 测试套名称 description String 描述 owner String 责任人 creator String 创建人id updator String 更新人 task_uri String 任务uri owner_name String 责任人名称 release_dev String 发布版本号 version_uri String 分支/迭代uri creator_name String 创建人名称 create_time String 创建时间 create_time_timestamp Long 创建时间时间戳 updator_name String 更新人名称 update_time String 更新时间 update_time_timestamp Long 更新时间时间戳 start_time String 开始时间 start_time_timestamp Long 开始时间时间戳 end_time String 结束时间 end_time_timestamp Long 开始时间时间戳 result_code Integer 执行结果Code result_name String 测试结果名称 finish_flg Integer 测试任务是否执行完成（0：未完成，1：已完成） project_uuid String 项目id 表7 ApiError 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：400 表8 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：401 表9 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：404 表10 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：500 表11 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及

请求示例 { "start_index" : 1, "end_index" : 2, "key_word" : "", "sort_field" : "", "sort_type" : "", "test_case_uris" : [ ], "is_async" : true, "feature_uri" : "907d6252400e4dafb33f489ba1510a1b" }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 owners 否 Array of strings 处理者 authors 否 Array of strings 创建者 ranks 否 Array of strings 用例等级 test_case_uris 否 Array of strings 用例Uris service_type 否 Integer 服务类型 task_uri 否 String 任务/测试套Uri feature_uri 否 String 目录Uri key_word 否 String 关键字 sort_field 否 String 排序字段 sort_type 否 String 升序/降序 start_index 否 String 起始位置 end_index 否 String 结束位置 start_time 否 String 创建日期范围起始时间 end_time 否 String 创建日期范围结束时间 last_exe_authors 否 Array of strings 最后一次执行用户 module_ids 否 Array of strings 模块id release_ids 否 Array of strings 迭代id status_codes 否 Array of strings 用例状态 result_codes 否 Array of strings 执行结果Code issue_id 否 String 需求id execute_start_time 否 String 最近执行时间范围起始时间 execute_end_time 否 String 最近执行时间范围结束时间 label_ids 否 Array of strings 标签Id include_sub_issue 否 Boolean 是否查询子需求关联的用例，默认true include_sub_feature 否 Boolean 是否查询子目录的用例，默认true case_type 否 Integer 用例类型 associated_issue 否 Boolean 是否关联需求（null：不限，false：未关联，true：已关联） associated_defects 否 Boolean 是否关联缺陷（null：不限，false：未关联，true：已关联） is_keyword 否 Boolean 是否组合关键字 issue_tree_search 否 Boolean 是否是需求树点击的查询关联用例 service_types 否 Array of integers 服务类型集合 stage_type 否 Integer 阶段过程（2：测试设计，3：测试执行，4：质量报告） custom_field_info 否 Array of QueryCustomFieldsInfo objects 用例自定义字段信息 is_async 否 Boolean 是否异步执行 test_designs 否 Array of booleans 是否来自测试设计（null或者[true, false]：不限，[true]：来自测试设计，[false]：否来自测试设计） not_assign_task 否 Boolean 该字段为false,则查询全量用例，为true表示查询未分配测试套的用例 test_types 否 Array of strings 类型 review_status 否 Integer 用例评审状态 表3 QueryCustomFieldsInfo 参数 是否必选 参数类型 描述 id 否 Integer 参数解释: 测试用例自定义字段Id 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 values 否 Array of strings 参数解释: 测试用例自定义字段值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 field_name 否 String 参数解释: 自定义字段名 约束限制: 不涉及 取值范围: 优先取id再取fieldName 默认取值: 不涉及

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status String 参数解释: 本次请求的处理状态 取值范围: success|error result ResultValueString object 参数解释: 请求结果 取值范围: 非必返 error ApiError object 参数解释: 错误信息 取值范围: 非必返 request_id String 参数解释: 请求的唯一id 取值范围: 非必返 address String 参数解释: 本次请求的受理的服务地址。 取值范围: 非必返 表5 ResultValueString 参数 参数类型 描述 value String 参数解释 resultObject 取值范围 不涉及 表6 ApiError 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：400 表7 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：401 表8 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：404 表9 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：500 表10 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及

响应参数 状态码：200 表2 响应Body参数 参数 参数类型 描述 value Boolean 实际的数据类型：单个对象，集合 或 NULL 状态码：400 表3 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：401 表4 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：404 表5 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：500 表6 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及

请求示例 post https://{endpoint}/GT3KServer/v4/iterators/v92s00010db209le/testcases/batch-add? { "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d", "is_all_issues" : 0, "invert_simple_resourceinfo_list" : [ ], "simple_resourceinfo_list" : [ { "resource_id" : "v92s00010db20aij" }, { "resource_id" : "v92s00010db20aiq" }, { "resource_id" : "v92s00010db20aj1" }, { "resource_id" : "v92s00010db20aj6" }, { "resource_id" : "v92s00010db20ajc" }, { "resource_id" : "v92s00010db20aji" }, { "resource_id" : "v92u00010e58tdun" } ], "type" : -1, "add_to_iterator" : false }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 project_uuid 否 String 项目id iterator_uri 否 String 迭代uri type 否 Integer 资源类型, 对应serviceType is_all_issues 否 String 是否选择issues all_import 否 Boolean 是否选择所有用例 feature_uri 否 String 按照目录引入用例 simple_resourceinfo_list 否 Array of SimpleResourceInfo objects 选择的资源列表, 对应sourceCaseUris invert_simple_resourceinfo_list 否 Array of SimpleResourceInfo objects 反选的资源列表 add_to_iterator 否 Boolean 是否将需求添加到测试计划（不传或者true添加需求到测试计划，false就不添加） 表4 SimpleResourceInfo 参数 是否必选 参数类型 描述 type 否 String 资源类型 owner 否 String 资源责任人 resource_id 否 String 资源id

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 status String 参数解释 success|error; 取值范围 success|error result ResultValueStringForOk object 请求结果 表6 ResultValueStringForOk 参数 参数类型 描述 value String 参数解释 ok 取值范围 不涉及 状态码：400 表7 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：401 表8 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：404 表9 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：500 表10 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及

响应示例 状态码：200 OK { "status" : "success", "result" : { "value" : { "uri" : "v91j0000vldlep5u", "name" : "样例功能套件", "number" : "002", "region" : "cn-north-7", "author_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "author_name" : "xxx", "owner_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "owner_name" : "xxx", "parent_path" : "/300c6295a54c4c698608c878f47ddd59/v91j0000vldleo9v/", "version_uri" : "v91j0000vldleo9v", "branch_uri" : "v91j0000vldleo9v", "creation_date" : "2024-06-24 10:26:19", "create_date_timestamp" : 1719195979000, "update_time" : "2024-06-24 10:26:19", "update_time_timestamp" : 1719195979000, "relation_change_time" : "2024-06-24 10:26:19", "relation_change_time_timestamp" : 1719195979000, "updator_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "relation_changer_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "service_type" : 0, "tag_list" : [ ], "execute_way" : 1, "execute_type" : 0, "status_code" : 0, "execute_status_code" : 0, "project_uuid" : "300c6295a54c4c698608c878f47ddd59", "case_operation_info" : { "test_cases_info" : [ { "case_uri" : "v91j0000vldlep4q", "sort" : 1, "is_available" : 1, "test_case_name" : "样例功能用例_修改", "test_case_number" : "008" } ], "set_up_cases_info" : [ ], "tear_down_cases_info" : [ ] }, "assign_case_num" : 0, "finish_case_num" : 0, "assign_defect_num" : 0, "iterator_version_uri" : "v91j0000vldleodb" } } }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status String success|error; result ResultValueTaskVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址 表5 ResultValueTaskVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value TaskVo object 测试任务集合 reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表6 TaskVo 参数 参数类型 描述 uri String 测试任务URI name String 测试任务名称 stage String 测试阶段 number String 编号 tags String 标签 description String 描述 region String 区域 author_id String 创建人ID author_name String 创建人名称 owner_id String 责任人ID owner_name String 责任人名称 parent_uri String 父任务URI parent_path String 父任务路径 origin_uri String 源任务URI version_uri String 版本URI branch_uri String 分支URI version_name String 版本名称 creation_date String 创建时间 create_date_timestamp Long 创建时间时间戳 update_time String 更新时间 update_time_timestamp Long 更新时间时间戳 relation_change_time String 关联关系修改时时间 relation_change_time_timestamp Long 关联关系修改时间时间戳 test_case_condition String 动态任务用例过滤条件 updator_id String 修改人Id updator_name String 修改人名称 relation_changer_id String 关联关系修改人Id service_type Integer 服务类型ID service_type_name String 服务类型名称 tag_list Array of strings 标签名称集合 module_id String 模块ID module_name String 模块名称 module_path String 模块path module_path_name String 模块路径名称 release_dev String 发布版本号 ext_param String 扩展参数 execute_way Integer 执行方式（1：串行，2：并行） execute_type Integer 执行类型（0：冒烟，1：定时） status_code Integer 生命周期状态Code status_name String 生命周期状态名称 result_code Integer 执行结果Code result_name String 执行状态名称 execute_status_code Integer Echo执行状态Code execute_status_name String Echo执行状态名称 executor_id String 执行人ID executor_name String 执行人名称 execute_latest_time String 最近执行时间 execute_latest_time_timestamp Long 最近执行时间时间戳 execute_duration String 执行时长 execute_times Integer 执行次数 project_uuid String 项目ID case_operation_info CaseOperationVo object 任务关联用例信息 assign_case_num Integer 关联用例数 finish_case_num Integer 已完成用例数量 assign_defect_num Integer 关联缺陷数量 task_assign_msg String 任务关联用例变更提示信息 iterator_version_uri String 测试套所属迭代uri，非迭代下创建的测试套返回null result_number_list Array of NameAndValueAndCodeVo objects 用户自定义结果对应的用例数目 finish_date String 测试套完成时间 finish_date_timestamp Long 测试套完成时间戳 plan_start_date String 计划开始时间 plan_start_timestamp Long 计划开始时间戳 plan_end_date String 计划结束时间 plan_end_timestamp Long 计划结束时间戳 expiration_status Integer 测试套超期状态值，分别为：无状态(null)、未超期(0)、即将超期(1)、已超期(2)、延期完成(3)、按期完成(4) expiration_status_name String 测试套超期状态名称，分别为：无状态(不显示状态)、未超期(Unexpired)、即将超期(About to expire)、已超期(Expired)、延期完成(Delayed completion)、按期完成(On schedule completion) 表7 CaseOperationVo 参数 参数类型 描述 test_cases_info Array of TaskAssignCaseVo objects 用例关联信息 set_up_cases_info Array of TaskAssignCaseVo objects 前置用例关联信息 tear_down_cases_info Array of TaskAssignCaseVo objects 后置用例关联信息 表8 TaskAssignCaseVo 参数 参数类型 描述 sort Integer 排序顺序 case_uri String 用例uri is_available Integer 是否可用 test_case_name String 用例名称 test_case_number String 用例编号 表9 NameAndValueAndCodeVo 参数 参数类型 描述 name String 名称 value Integer 值 code String 编码 表10 ApiError 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：400 表11 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：401 表12 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：404 表13 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及 状态码：500 表14 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 接口调用失败错误码 取值范围: 不涉及 error_msg String 参数解释: 接口调用失败错误信息 取值范围: 不涉及

URI GET /v4/{project_id}/tasks/{task_uri} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及 task_uri 是 String 任务uri 表2 Query参数 参数 是否必选 参数类型 描述 version_uri 否 String 分支/迭代uri