华为云用户手册

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 code String 接口调用状态码 data Array of SystemConfig objects 系统配置数据 message String 接口调用返回信息 表6 SystemConfig 参数 参数类型 描述 id String 系统配置编号 key String 系统配置名称 value String 系统配置值 remark String 描述 region_id String region_id project_id String 项目ID update_time String 更新时间 update_name String 更新人名称 update_num String 更新人编号 状态码： 400 表7 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 401 表8 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 404 表9 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息 状态码： 500 表10 响应Body参数 参数 参数类型 描述 code String 接口调用错误码 data String 接口调用返回体 message String 接口调用错误信息

响应示例 状态码： 200 OK { "code" : "success", "data" : [ { "id" : "ae3b4faf12f84ba1aa1c1fa372ec3dfd", "key" : "generateCaseStepByStep", "value" : "0", "remark" : null, "region_id" : "cn-north-7", "project_id" : "fb07002bf4ae4317a855b590a86a52e0", "update_time" : "2024/06/07 10:50:21 GMT+08:00", "update_name" : "devcloud_testman_01", "update_num" : "e8ad9e7478c94f4eaf90d5a379af9cb1" } ], "message" : null }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 params 是 SystemConfig object 系统配置信息 表4 SystemConfig 参数 是否必选 参数类型 描述 id 否 String 系统配置编号 key 否 String 系统配置名称 value 否 String 系统配置值 remark 否 String 描述 region_id 否 String region_id project_id 否 String 项目ID update_time 否 String 更新时间 update_name 否 String 更新人名称 update_num 否 String 更新人编号

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 value Array of AttachmentVo objects 实际的数据类型：单个对象，集合 或 NULL 表5 AttachmentVo 参数 参数类型 描述 uri String 附件Uri creator String 创建人 updator String 更新人 region String 逻辑region doc_id String 文档id parent_uri String 父节点Uri parent_type String 父节点类型 file_name String 文件名 store_file_name String 保存文件名 file_path String 文件路径 file_size Integer 文件大小 file_type String 文件类型 system_type String 系统区分：docman或testman create_time String 创建时间 create_time_timestamp Long 创建时间时间戳 update_time String 更新时间 update_time_timestamp Long 更新时间时间戳 project_uuid String 项目id related_type String 附件类型 0 本地上传 other 关联文档 状态码： 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 业务失败的提示内容

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

响应示例 状态码： 200 OK { "status" : "success", "result" : { "value" : { "uri" : "v91k0000vrroldin", "name" : "自定义1", "filter" : "{\"moduleIds\":[\"undefined\"]}", "updator" : "efdb403066474ab08836b9eeaaa23bca", "region" : "cn-north-7", "service_type" : -1, "stage_type" : 2, "user_id" : "efdb403066474ab08836b9eeaaa23bca", "creator" : "efdb403066474ab08836b9eeaaa23bca", "project_uuid" : "3d2378e0fc504c638f48b21377d6add1" } } }

请求示例 新增自定义过滤器 post https://{endpoint}/v4/projects/3d2378e0fc504c638f48b21377d6add1/filters { "filter_content_info" : { "results" : [ -2 ] }, "name" : "未执行用例", "project_uuid" : "84b218bb1b504019bbeb64b8dc745a94", "service_type" : -1, "stage_type" : "2" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueCustomizedFilterVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址。 表5 ResultValueCustomizedFilterVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value CustomizedFilterVo object 实际的数据类型：单个对象，集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表6 CustomizedFilterVo 参数 参数类型 描述 uri String 自定义过滤器URI name String 自定义过滤器名称 filter String 过滤器内容 type Integer 过滤器类型（1：设计页功能用例，2：设计页接口用例 ，3：执行页功能用例 ，4：执行页接口用例） updator String 更新人 region String 逻辑Region service_type Integer 服务类型 stage_type Integer 阶段过程（2：测试设计，3：测试执行，4：质量报告） user_id String 用户ID creator String 创建人 create_time String 创建时间 create_time_timestamp Long 创建时间时间戳 update_time String 更新时间 update_time_timestamp Long 更新时间时间戳 project_id 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 接口调用失败错误信息

响应示例 状态码： 200 OK { "status" : "success", "result" : { "total" : 2, "value" : [ { "uri" : "v9210000vrmhplil", "author" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "region" : "cn-north-7", "changes" : [ { "field_name" : "defectId", "old_key" : "", "new_key" : "8444611", "new_object_value" : [ "用例3新建" ], "new_object_key" : [ "8444611" ], "new_tracker_names" : [ "Bug" ], "new_board_info" : [ ], "new_display_ids" : [ "8444611" ] } ], "resource_uri" : "v91j0000vq997opk", "resource_type" : "TestCase", "version_uri" : "v91i0000vq98suq1", "creation_date" : "2024-09-10 10:49:43", "create_date_timestamp" : 1725936583000, "author_name" : "xxx" }, { "uri" : "v91i0000vrmh72fb", "author" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "region" : "cn-north-7", "changes" : [ { "field_name" : "svnScriptPath", "new_value" : "fail1.py" } ], "resource_uri" : "v91j0000vq997opk", "resource_type" : "TestCase", "version_uri" : "v91i0000vq98suq1", "creation_date" : "2024-09-10 10:39:34", "create_date_timestamp" : 1725935974000, "author_name" : "xxx" } ], "page_size" : 10, "page_no" : 1 } }

请求示例 获取资源修改历史记录 post https://{endpoint}/v4/resources/v91j0000vq997opk/histories/batch-query { "page_no" : 1, "project_uuid" : "30649eb093c2479d92c74c75d36ef280", "version_uri" : "v91i0000vq98suq1", "page_size" : 10, "type" : "TestCase" }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 status String success|error; result ResultValueListResourceHistoryVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入，建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址 表6 ResultValueListResourceHistoryVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 value Array of ResourceHistoryVo objects 实际的数据类型：单个对象，集合 或 NULL reason String 错误信息 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表7 ResourceHistoryVo 参数 参数类型 描述 uri String 资源历史记录Uri author String 资源历史记录创建人 region String 逻辑region changes Array of ResourceChangeVo objects 资源历史记录字段变更列表 resource_uri String 资源uri resource_type String 资源类型 version_uri String 分支/迭代uri creation_date String 创建时间 create_date_timestamp Long 创建时间时间戳 author_name String 创建人名称 not_empty Boolean 非空 project_id String 项目id 表8 ResourceChangeVo 参数 参数类型 描述 only_new_value Boolean 只展示新值 field_name String 变更字段 old_value String 旧值 old_tracker_name String 旧工作项类型 new_tracker_name String 新工作项类型 new_value String 新值 old_key String 原key new_key String 新key old_object_value Object 旧对象值 new_object_value Object 新对象值 old_object_key Object 新object key new_object_key Object 新object key old_tracker_names Object 旧tracker_names new_tracker_names Object 新旧tracker_names old_board_info Array of JSONObject objects 变更前归属看板信息，用例关联工作项信息使用 new_board_info Array of JSONObject objects 变更后归属看板信息，用例关联工作项信息使用 old_display_ids Array of strings 老值，用于前端展示。IPD和Xboard项目的需求和缺陷sequenceId列表，非IPD和Xboard项目的需求和缺陷Id列表。由于需求只能关联一个，所以需求取第一个值 new_display_ids Array of strings 新值，用于前端展示。IPD和Xboard项目的需求和缺陷sequenceId列表，非IPD和Xboard项目的需求和缺陷Id列表。由于需求只能关联一个，所以需求取第一个值 old_test_item_path_name String 变更前路径（目录名称路径） new_test_item_path_name String 变更后路径（目录名称路径） custom_field_type String 测试用例自定义字段类型 表9 JSONObject 参数 参数类型 描述 empty Boolean 是否为空 additionalProperties Object 变更后归属看板信息，用例关联工作项信息使用 表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 接口调用失败错误信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 conditions 否 Array of SearchCondition objects 搜索条件 type 否 String 资源类型 useOffset 否 Boolean 是否使用offset分页 project_id 否 String 项目ID version_uri 否 String 分支/迭代uri page_no 否 Integer 页码 page_size 否 Integer 每页展示条数 表4 SearchCondition 参数 是否必选 参数类型 描述 field_name 否 String 字段名 field_value 否 String 字段值 operator 否 String 数据库字段操作 sour_value 否 String 源值 tar_value 否 String 目标值 field_type 否 String 字段类型

响应示例 状态码： 201 OK [ { "detail" : [ { "added" : [ { "id" : "ID", "name" : "名称" } ], "deleted" : [ { "id" : "ID", "name" : "名称" } ], "journalized_type" : "plan", "type" : "resource/attribute", "updated" : [ { "attribute_type" : "name", "new_value" : "tester", "old_value" : "test" } ] } ], "operate_time" : "2021-07-10", "operator" : { "id" : "ID", "name" : "名称" }, "plan_id" : "c7c2ddf2ea914164ac6ee76bf11a30ea", "project_id" : "9b26f58ec29943f681804a6628779a23" } ]

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 [数组元素] Array of TestPlanJournalList objects 项目下查询测试计划操作历史返回结构 表5 TestPlanJournalList 参数 参数类型 描述 detail Array of TestPlanJournalDetail objects 历史记录详情 operate_time String 变更时间 operator NameAndId object 测试计划迭代编号与迭代名称 plan_id String 测试计划id project_id String 项目id，项目唯一标识，固定长度32位字符 表6 TestPlanJournalDetail 参数 参数类型 描述 added Array of NameAndId objects 测试计划资源的添加记录（工作项或者测试用例） deleted Array of NameAndId objects 测试计划资源的移除记录（工作项或者测试用例） journalized_type String 表明该条变更记录的具体变更类型，例如测试用例（testCase），需求（issue） type String 表明该条变更记录属于基础信息变更还是资源（需求添加移除、用例添加移除）变更 updated Array of AttributeChange objects 测试计划基础信息变更，包括计划名称，测试类型，计划处理者、版本号、关联迭代、开始日期、截至日期、描述 表7 NameAndId 参数 参数类型 描述 id String 对象编号 name String 对象名称 表8 AttributeChange 参数 参数类型 描述 attribute_type String 发生变更的测试计划属性 new_value String 变更后的取值 old_value String 变更前的取值 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 401 表10 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 404 表11 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 500 表12 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息

URI GET /v1/projects/{project_id}/plans/{plan_id}/journals 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id，项目唯一标识，固定长度32位字符，获取方式请参见获取项目ID。 plan_id 是 String 测试计划id，测试计划的唯一标识，长度11-34位字符 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Long 起始偏移量，表示从此偏移量开始查询， offset大于等于0 limit 是 Long 每页显示的条目数量,最大支持200条

响应示例 状态码： 200 SUC CES S { "status" : "success", "result" : { "page_no" : 1, "page_size" : 1, "total_page" : 1, "total_size" : 1, "page_list" : [ { "id" : "10f9bbc251754dfe9a778e16ec58accb", "type" : "String", "name" : "hostURL", "property" : "127.0.0.1:8080", "description" : null, "locked" : null, "groupId" : "f56886074692465d8b3a50c74c136b53", "category" : "Static", "isSensitiveInfo" : false, "isSensitiveModified" : false, "sourceId" : null, "variableType" : 0, "functionParams" : "127.0.0.1:8080", "dynamicParamFlag" : false, "sensitiveInfoSetterUser" : null, "sensitiveInfoSetterTime" : null, "currentPermission" : null, "region" : "cn-north-7", "create_time_string" : "2024-04-29 15:43:05 GMT+08:00", "update_time_string" : "2024-04-29 15:43:05 GMT+08:00", "create_time_stamp" : 1714376585000, "update_time_stamp" : 1714376585000, "create_user" : "devcloud_devcloud_s00314720_01", "create_time" : "2024-04-29T03:43:05+0800", "update_user" : "devcloud_devcloud_s00314720_01", "update_time" : "2024-04-29T03:43:05+0800", "parent_id" : "26927372bbae40b184fe764e7a0d21f7", "node_type" : null, "node_id" : null, "parent_node_id" : null, "by_order" : 1 } ] }, "reason" : null, "error" : null, "code" : null }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 code String 错误码 error CommonResponseErrorOfAPITest object 统一错误返回 reason String 失败原因 result PageResults object 结果 status String 状态 表5 CommonResponseErrorOfAPITest 参数 参数类型 描述 code String 错误码 reason String 错误原因 表6 PageResults 参数 参数类型 描述 page_list Array of VariableRes objects 全局变量列表 page_no Integer 当前分页 page_size Integer 分页大小 total_page Integer 全部分页 total_size Long 全局变量总数 表7 VariableRes 参数 参数类型 描述 by_order Integer 节点顺序 category String 节点所在目录 create_time String 创建时间 create_time_stamp Long 创建时间（时间戳格式） create_time_string String 创建时间（字符串格式） create_user String 创建人 currentPermission String 当前用户权限 description String 备注信息 dynamicParamFlag Boolean 是否为动态变量 functionParams String 变量参数 groupId String 分组信息 id String 变量编号 isSensitiveInfo Boolean 是否为敏感变量 isSensitiveModified Boolean 敏感字段是否被修改 locked Integer 是否被锁定 name String 变量名 node_id String 节点编号 node_type Integer 节点类型 parent_id String 所属父节点编号 parent_node_id String 父节点编号 property String 变量值 region String 所在region sensitiveInfoSetterTime String 敏感变量设置时间 sensitiveInfoSetterUser String 敏感变量设置者 sourceId String 复制的全局变量的源id type String 变量类型 update_time String 更新时间 update_time_stamp Long 更新时间（时间戳格式） update_time_string String 更新时间（字符串格式） update_user String 更新人 variableType Integer 变量类型

请求示例 创建自定义测试服务类型用例 post https://{endpoint}/v1/projects/efdb403066474ab08836b9eeaaa23bca/testcases { "extend_info" : { "assigned_id" : "1111", "description" : "这是一段用例描述信息", "fix_version_id" : "11111", "issue_id" : "11111", "label_list" : [ "标签名称" ], "module_id" : "模块号", "preparation" : "需要满足的前置条件", "steps" : [ { "expect_result" : "[\"\\u003cp\\u003e预期结果1\\u003c/p\\u003e\",\"\\u003cp\\u003e预期结果2\\u003c/p\\u003e\"]", "test_step" : "[\"\\u003cp\\u003e步骤描述1\\u003c/p\\u003e\",\"\\u003cp\\u003e步骤描述2\\u003c/p\\u003e\"]" } ], "test_version_id" : "11111" }, "name" : "testcase", "rank_id" : "2", "service_id" : 13, "testcase_number" : "1234" }

响应示例 状态码： 201 Created { "assigned_user" : { "id" : "ID", "name" : "名称" }, "execute_count" : 4, "extend_info" : { "author" : { "id" : "1111", "name" : "名称", "time" : "2000-01-01 00:00:00" }, "defect_list" : [ { "id" : "ID", "name" : "名称" } ], "description" : "描述信息", "domain" : { "id" : "ID", "name" : "名称" }, "fixed_version" : { "id" : "ID", "name" : "名称" }, "issue" : { "id" : "ID", "name" : "名称" }, "label_list" : [ { "id" : "ID", "name" : "名称" } ], "module" : { "id" : "ID", "name" : "名称" }, "preparation" : "前置条件", "steps" : [ { "expect_result" : "[\"\\u003cp\\u003e预期结果1\\u003c/p\\u003e\",\"\\u003cp\\u003e预期结果2\\u003c/p\\u003e\"]", "test_step" : "[\"\\u003cp\\u003e步骤描述1\\u003c/p\\u003e\",\"\\u003cp\\u003e步骤描述2\\u003c/p\\u003e\"]" } ], "test_version_id" : "97b82412f1", "updator" : { "id" : "1111", "name" : "名称", "time" : "2000-01-01 00:00:00" } }, "name" : "某个测试用例", "project_id" : "2394921", "rank_id" : "2", "result_id" : "0", "service_id" : 13, "status_id" : "1", "testcase_id" : "97b82412f1ca4628803b918c27ed09de", "testcase_number" : "1234" }

响应参数 状态码： 201 表6 响应Body参数 参数 参数类型 描述 assigned_user AssignedUserInfo object 处理者信息 execute_count Integer 测试用例执行次数 extend_info ExtendInfo object 测试用例扩展信息 name String 测试用例名称 project_id String 软开云项目唯一标识 rank_id String 测试用例等级 result_id String 测试用例执行结果 service_id Integer 注册测试类型服务接口返回的服务id status_id String 测试用例状态 testcase_id String 用例uri,测试用例唯一标识,长度11-34位字符（字母和数字）。 testcase_number String 测试用例编号 表7 ExtendInfo 参数 参数类型 描述 author ExtendAuthorInfo object 创建者信息 defect_list Array of AssignedUserInfo objects 缺陷信息 description String 描述信息 domain AssignedUserInfo object 租户信息 fixed_version AssignedUserInfo object 迭代信息 issue AssignedUserInfo object 需求信息 label_list Array of AssignedUserInfo objects 标签信息 module AssignedUserInfo object 模块信息 preparation String 前置条件 steps Array of ExternalServiceCaseStep objects 测试步骤，数组长度小于10 test_version_id String 测试版本号 updator ExtendAuthorInfo object 更新者信息 表8 AssignedUserInfo 参数 参数类型 描述 id String id信息 name String 名称信息 表9 ExternalServiceCaseStep 参数 参数类型 描述 expect_result String 测试用例预期结果信息，长度为[0-500]位字符 test_step String 测试步骤描述信息，长度为[0-500]位字符 表10 ExtendAuthorInfo 参数 参数类型 描述 id String id信息 name String 名称信息 time 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 接口调用失败错误信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 extend_info 否 ExternalServiceCaseInfo object 测试用例其他扩展信息 name 是 String 页面上显示的用例名称，长度为[3-128]位字符 rank_id 否 String 测试用例等级，可选值为[0,1,2,3,4]，不填时默认为2 service_id 是 Integer 该值由注册接口返回，取值范围为10-9999 testcase_number 否 String 用例编号，不填该值时会自动生成，长度为[3-128]位字符 表4 ExternalServiceCaseInfo 参数 是否必选 参数类型 描述 assigned_id 否 String 处理者id信息，长度为0-32。 description 否 String 测试用例描述信息，长度为[0-500]位字符 fix_version_id 否 String 迭代号，长度为[0-32]位字符 issue_id 否 String 用例关联的需求id信息，长度为[0-32]位字符 label_list 否 Array of strings 标签名称列表，数组长度小于等于30。单个名称长度不超过25。 module_id 否 String 模块号，长度为0-32。 preparation 否 String 执行该测试用例时需要满足的前置条件，长度为[0-500]位字符 steps 否 Array of ExternalServiceCaseStep objects 测试步骤，数组长度小于10 test_version_id 否 String 测试版本号，长度为1-64。 表5 ExternalServiceCaseStep 参数 是否必选 参数类型 描述 expect_result 否 String 测试用例预期结果信息，长度为[0-500]位字符 test_step 否 String 测试步骤描述信息，长度为[0-500]位字符

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 status String 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 业务失败的提示内容

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 relations 否 Array of RelationInfo objects 关联关系 tracker_id 否 String 工作项类型id version_uri 否 String 版本uri task_uri 否 String 测试套id add_to_iterator 否 Boolean 是否将需求添加到迭代 project_uuid 否 String 项目id 表4 RelationInfo 参数 是否必选 参数类型 描述 dr_number 是 String 需求id test_case_uri 否 String 用例uri relate_type 是 String 资源类型 resource_type 否 String 资源类型 source_system 否 String 来源系统 association_number 否 String 关联资源编号 region 否 String 逻辑region，外部使用公有云实际区域，内部使用默认值

响应示例 状态码： 200 OK { "values" : [ { "name" : "测试用例", "owner" : { "id" : "id", "name" : "name" }, "status" : { "id" : "id", "name" : "name" }, "result" : { "id" : "id", "name" : "name" }, "module" : { "id" : "id", "name" : "name" }, "iteration" : { "id" : "id", "name" : "name" }, "id" : "001rv8lk4he", "number" : "10010", "description" : "用例描述", "rank_id" : "2", "project_id" : "7672757", "execution_type" : { "id" : "id", "name" : "name" }, "test_type" : { "id" : 1, "name" : "显示值" }, "create_info" : { "time" : "2021-11-06 00:00:01", "timestamp" : 1660617231016, "user_id" : "efdb403066474ab08836b9eeaaa23bca", "user_name" : "测试Tester" }, "execute_info" : { "time" : "2021-11-06 12:00:00", "timestamp" : 1660617231016, "duration" : "00:00:10", "user_id" : "efdb403066474ab08836b9eeaaa23bca", "user_name" : "测试Tester", "execute_times" : 1 }, "associate_issue_info" : { "associate" : true, "issue_id" : "4654022505049243648", "tracker_id" : "1", "board_id" : "443ef10e6c954b00a24ed6ce6864854a", "tracker_name" : "IR" }, "associate_defect_info" : { "associate" : true, "associate_count" : 1 } } ], "total" : 1 }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 values Array of ExternalTestCaseVo objects 用例详情列表 total Integer 用例总数 表5 ExternalTestCaseVo 参数 参数类型 描述 name String 用例名称 owner NameAndIdVo object 处理者信息 status NameAndIdVo object 状态信息 result NameAndIdVo object 结果信息 module NameAndIdVo object 模块信息 iteration NameAndIdVo object 迭代信息 id String 用例ID number String 用例编号 description String 用例描述 rank_id String 用例等级 project_id String 项目ID execution_type NameAndIdVo object 用例测试执行类型 test_type IntegerIdAndNameVo object 测试类型信息 create_info CreateInfoVo object 创建信息 execute_info ExecuteInfoVo object 执行信息 associate_issue_info AssociateIssueInfoVo object 关联需求信息 associate_defect_info AssociateDefectInfoVo object 关联缺陷信息 表6 NameAndIdVo 参数 参数类型 描述 id String ID name String 名称 表7 IntegerIdAndNameVo 参数 参数类型 描述 id Integer 数据库存储数字 name String 页面显示值 表8 CreateInfoVo 参数 参数类型 描述 time String 创建时间 timestamp Long 创建时间时间戳 user_id String 用户ID user_name String 用户名称 表9 ExecuteInfoVo 参数 参数类型 描述 time String 执行开始时间 timestamp Long 执行开始时间时间戳 duration String 执行时长 user_id String 用户ID user_name String 用户名称 execute_times Integer 执行次数 表10 AssociateIssueInfoVo 参数 参数类型 描述 associate Boolean 是否已关联 issue_id String 需求ID tracker_id String 需求类型 board_id String 工作项层级ID tracker_name String 需求类型名称 表11 AssociateDefectInfoVo 参数 参数类型 描述 associate Boolean 是否已关联 associate_count Integer 关联缺陷数 状态码： 400 表12 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 401 表13 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 404 表14 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码： 500 表15 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 offset 是 Integer 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 limit 是 Integer 每页显示的条目数量，最大支持200条 execution_type_id 否 Integer 用例测试执行方式ID version_id 否 String 分支/测试计划ID，长度11-34位字符（字母和数字）。

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 status String 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 业务失败的提示内容

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 workitem_list 是 Array of WorkItemInfo objects 关联需求 is_delete_case 否 Boolean 是否删除需求关联的用例 表4 WorkItemInfo 参数 是否必选 参数类型 描述 work_item_id 是 String 工作项编号 has_child 是 Boolean 是否有子需求 is_open 是 Boolean 是否展开 child_list 否 Array of WorkItemInfo objects 子需求

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 page_no Integer 当前页 page_size Integer 每页大小 total_page Integer 总页数 total_size Integer 总条数 page_list Array of AlarmTemplateInfo objects 查询到的告警模板 表5 AlarmTemplateInfo 参数 参数类型 描述 create_time String 创建时间 create_user String 创建者 id String UUID remarks String 备注 test_service_id String 服务id update_time String 修改时间 update_user String 修改者 name String 模板名称 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误编码 error_msg String 错误原因