华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表3 FormData参数 参数 是否必选 参数类型 描述 req 是 File 要上传的yaml文件

响应示例 状态码：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"}

请求示例 创建自定义测试服务类型用例 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 表6 响应Body参数 参数 参数类型 描述 assigned_user AssignedUserInfo object 参数解释: 处理者信息 取值范围: 不涉及 execute_count Integer 参数解释: 测试用例执行次数 取值范围: 不涉及 extend_info ExtendInfo object 参数解释: 测试用例扩展信息 取值范围: 不涉及 name String 参数解释: 测试用例名称 取值范围: 不涉及 project_id String 参数解释: 软开云项目唯一标识 取值范围: 不涉及 rank_id String 参数解释: 测试用例等级 取值范围: 0|1|2|3|4 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的值） 约束限制 不涉及 取值范围 字符串长度不少于1，不超过100000 默认取值 不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 extend_info 否 ExternalServiceCaseInfo object 参数解释: 测试用例其他扩展信息}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 name 是 String 参数解释: 页面上显示的用例名称 约束限制: 不涉及 取值范围: 3-128位字符 默认取值: 不涉及 rank_id 否 String 参数解释: 测试用例等级 约束限制: 不涉及 取值范围: 0,1,2,3,4 默认取值: 2 service_id 是 Integer 参数解释: 服务id,该值由注册接口返回 约束限制: 不涉及 取值范围: 10-9999 默认取值: 2 testcase_number 否 String 参数解释: 用例编号 约束限制: 不涉及 取值范围: 3-128位字符 默认取值: 不填该值时会自动生成 表4 ExternalServiceCaseInfo 参数 是否必选 参数类型 描述 assigned_id 否 String 参数解释: 处理者id信息 约束限制: 不涉及 取值范围: 0-32 默认取值: 不涉及 description 否 String 参数解释: 处理者id信息 约束限制: 不涉及 取值范围: 0-500位字符 默认取值: 不涉及 fix_version_id 否 String 参数解释: 迭代号 约束限制: 不涉及 取值范围: 0-32位字符 默认取值: 不涉及 issue_id 否 String 参数解释: 用例关联的需求id信息 约束限制: 不涉及 取值范围: 0-32位字符 默认取值: 不涉及 label_list 否 Array of strings 参数解释: 标签名称列表 约束限制: 单个名称长度不超过25 取值范围: 小于等于30 默认取值: 不涉及 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位字符 默认取值: 不涉及

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表4 请求Body参数 参数 是否必选 参数类型 描述 CreateTestCaseAndScriptTwoRequestBody 否 String 用例脚本信息

请求示例 { "name" : "TC_ZPduq", "script_name" : "TC_ZPduq", "releaseDev" : "", "tmss_case_uri" : "", "activity_id" : 1, "tmss_property" : { "name" : "TC_ZPduq", "description" : "", "preparation" : "", "steps" : [ { "testStep" : "", "expectResult" : "" } ], "number" : "", "level" : "2", "moduleId" : "", "releaseDev" : "", "releaseId" : "", "ownerId" : "", "test_type" : 1, "labelId" : [ ], "exe_platform" : "apitest" }, "import_info_list" : [ ], "case_variable_list" : [ ], "aw_instance" : { "setup_aw_list" : [ ], "test_aw_list" : [ ], "teardown_aw_list" : [ ] }, "source" : "cloudtest"}

URI POST /v2/{project_id}/testcase 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目唯一标识。 约束限制 不涉及 取值范围 32个字符组成的字符串 默认取值 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 iterator_uri 否 String 迭代uri

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 error CommonResponseErrorOfobject object 统一错误返回 reason String 错误原因 result Object 结果 status String 状态值，如success、error 表6 CommonResponseErrorOfobject 参数 参数类型 描述 code String 错误码 reason String 错误原因

响应示例 状态码：200 SUC CES S { "status" : "success", "result" : { "id" : "ff9f737472a14508a971192adba88299", "name" : "123", "deleteFlag" : null, "changeSign" : 0, "planId" : null, "issueId" : "", "addToPlan" : null, "releaseDev" : "", "copyFlag" : false, "source" : "cloudtest", "region" : "{region}", "status" : null, "create_time_string" : "2024-07-04 15:02:55 GMT+08:00", "update_time_string" : "2024-07-04 15:02:55", "create_time_stamp" : 1720076575000, "update_time_stamp" : 1720076575000, "create_user" : "devcloud_devcloud_s00314720_01", "create_time" : "2024-07-04T03:02:55+0800", "update_user" : "devcloud_devcloud_s00314720_01", "update_time" : "2024-07-04T03:02:55+0800", "tmss_property" : { "name" : "123", "description" : "", "number" : "102", "cataId" : null, "labelId" : [ ], "tags" : null, "level" : 2, "preparation" : "", "market" : null, "remark" : null, "originUri" : null, "releaseDev" : "", "stage" : null, "moduleId" : "", "releaseId" : "", "uri" : null, "node_name" : null, "test_type" : 1, "testStep" : null, "test_step" : null, "expectOutput" : null, "expect_output" : null, "env_type" : null, "exe_platform" : "apitest", "auto_type" : "1", "is_contract_testcase" : null, "is_paraValidator_testcase" : null, "test_feature" : null, "last_modified" : null, "last_modifier" : null, "author" : null, "creation_date" : null, "activity_id" : null, "owner" : null, "feature_path" : null, "ownerId" : "", "dr_relationid" : null, "applied_product" : null, "last_result" : null, "isKeyWord" : null, "steps" : [ { "testStep" : "", "expectResult" : "" } ], "networkScriptName" : null, "svnScriptPath" : null }, "project_id" : "b7cb42f3fec14acba074624ddccd30db", "logic_case_id" : null, "activity_id" : "1", "package_name" : "scripts.user", "script_name" : "Case_ff9f737472a14508a971192adba88299_1", "script_path" : "src/scripts/user/Case_ff9f737472a14508a971192adba88299_1.java", "tmss_case_uri" : "v91k0000vm7tgc0c", "aw_instance" : { "setup_aw_list" : [ ], "test_aw_list" : [ ], "teardown_aw_list" : [ ] }, "case_variable_list" : [ ], "quality_check_time" : null, "quality_check_result" : null, "tc_comments" : null, "import_info_list" : [ ], "IteratorCaseUri" : null, "IsKeyWord" : 0, "keyword_id" : null, "all_variable_names" : null, "variableGroupId" : null, "error_step" : null, "import_edit" : 5, "user_id" : null, "case_type" : 0 }, "reason" : null, "error" : null}

请求示例 { "name" : "CombinAW_98rZu", "description" : "CombinAW_description_Sqjhf", "import_package" : [ ], "aw_ins_list" : [ { "id" : "", "aw_id" : "", "aw_type" : 1, "is_disabled" : 0, "condition_type" : 20, "condition_statement" : 3000 } ], "group_name" : "ef3afde7e5144fdf8de1ecad0069b34d", "param_type_and_dft_value" : [ ], "keyword_variable_value" : [ ]}

响应参数 状态码：200 表18 响应Body参数 参数 参数类型 描述 code String 参数解释 错误码 error CommonResponseErrorObject object 参数解释 统一错误返回 reason String 参数解释 失败原因 result Object 参数解释 结果 status String 参数解释 响应状态 表19 CommonResponseErrorObject 参数 参数类型 描述 code String 参数解释 错误码 reason String 参数解释 错误原因 状态码：201 Created 状态码：401 表20 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：403 表21 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：404 表22 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串

响应示例 状态码：200 SUCCESS { "status" : "success", "result" : { "id" : "afa42e9100304aa8806d4beeffbebd2c", "name" : "123_2625", "deleteFlag" : null, "changeSign" : 0, "planId" : null, "issueId" : "", "addToPlan" : null, "releaseDev" : "", "copyFlag" : true, "source" : "cloudtest", "region" : "{region}", "status" : null, "create_time_stamp" : 1720081655000, "update_time_stamp" : null, "create_time_string" : "2024-07-04 16:27:35 GMT+08:00", "update_time_string" : null, "create_user" : "devcloud_devcloud_s00314720_01", "create_time" : "2024-07-04T04:27:35+0800", "update_user" : null, "update_time" : null, "tmss_property" : { "name" : "123_2625", "description" : "", "number" : "105", "cataId" : null, "labelId" : [ ], "tags" : null, "level" : 2, "preparation" : "", "market" : null, "remark" : null, "originUri" : null, "releaseDev" : "", "stage" : null, "moduleId" : "", "releaseId" : "", "customField1" : null, "customField2" : null, "customField3" : null, "customField4" : null, "customField5" : null, "customField6" : null, "customField7" : null, "customField8" : null, "custom_field_1" : null, "custom_field_2" : null, "custom_field_3" : null, "custom_field_4" : null, "custom_field_5" : null, "custom_field_6" : null, "custom_field_7" : null, "custom_field_8" : null, "custom_field_9" : null, "custom_field_10" : null, "custom_field_11" : null, "custom_field_12" : null, "custom_field_13" : null, "custom_field_14" : null, "custom_field_15" : null, "custom_field_16" : null, "custom_field_17" : null, "custom_field_18" : null, "custom_field_19" : null, "custom_field_20" : null, "custom_field_21" : null, "custom_field_22" : null, "custom_field_23" : null, "custom_field_24" : null, "custom_field_25" : null, "uri" : null, "node_name" : null, "test_type" : 1, "testStep" : null, "test_step" : null, "expectOutput" : null, "expect_output" : null, "env_type" : null, "exe_platform" : "apitest", "auto_type" : "1", "is_contract_testcase" : null, "is_paraValidator_testcase" : null, "test_feature" : null, "last_modified" : null, "last_modifier" : null, "author" : null, "creation_date" : null, "activity_id" : null, "owner" : null, "feature_path" : null, "ownerId" : "", "dr_relationid" : null, "applied_product" : null, "last_result" : null, "isKeyWord" : null, "steps" : [ { "testStep" : "", "expectResult" : "" } ], "networkScriptName" : null, "svnScriptPath" : null }, "project_id" : "b7cb42f3fec14acba074624ddccd30db", "logic_case_id" : null, "activity_id" : "1", "package_name" : "scripts.user", "script_name" : "Case_afa42e9100304aa8806d4beeffbebd2c_1", "script_path" : "src/scripts/user/Case_afa42e9100304aa8806d4beeffbebd2c_1.java", "tmss_case_uri" : "v91k0000vm823f04", "aw_instance" : { "setup_aw_list" : [ ], "test_aw_list" : [ { "id" : "897c954a5dc5467585a6fe4bebc1121b", "projectId" : "b7cb42f3fec14acba074624ddccd30db", "changeSign" : 0, "region" : "{region}", "relation" : "", "children" : null, "scriptName" : null, "create_time_stamp" : 1720081655000, "update_time_stamp" : 1720078110000, "create_time_string" : "2024-07-04 16:27:35 GMT+08:00", "update_time_string" : "2024-07-04 15:28:30 GMT+08:00", "create_user" : "devcloud_devcloud_s00314720_01", "create_time" : "2024-07-04T04:27:35+0800", "update_user" : "devcloud_devcloud_s00314720_01", "update_time" : "2024-07-04T03:28:30+0800", "name" : null, "condition_type" : 20, "condition_statement" : "1000", "body_param_type" : null, "aw_type" : 1, "aw_id" : "", "basic_aw" : null, "param_type_and_value" : [ ], "check_point_list" : [ ], "variable_list" : [ ], "retry_times" : "", "retry_interval" : "", "by_order" : 0, "from_outside" : null, "service_and_stage" : null, "is_contract_aw" : null, "is_sectest_aw" : null, "is_disabled" : 0, "param_dependent" : null, "param_dependent_enabled" : null, "relation_id" : null, "relation_type" : 0, "extra_info" : null, "custom_header" : [ ], "level" : null, "hasLevel" : null, "is_basic" : 1, "his_script" : null, "description" : null, "aw_description" : null, "user_id" : null, "special_type" : 0, "error_info" : null, "alias_runaw" : null, "authentication_type" : null, "authentication_info" : null, "output_alias_info" : null, "header_array" : null } ], "teardown_aw_list" : [ ] }, "case_variable_list" : [ ], "quality_check_time" : null, "quality_check_result" : null, "tc_comments" : null, "import_info_list" : [ ], "IteratorCaseUri" : null, "IsKeyWord" : 0, "keyword_id" : null, "all_variable_names" : null, "variableGroupId" : null, "error_step" : null, "import_edit" : 5, "user_id" : null, "case_type" : 0 }, "reason" : null, "error" : null}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表3 请求Body参数 参数 是否必选 参数类型 描述 CreateTMSSCaseAndCopyScriptRequestBody 是 String 用例脚本信息

请求示例 "{ "name": "TestCase_qAlGX_IJdpU_copy", "script_name": "TestCase_qAlGX_N1R10_copy", "create_time_string": "", "update_time_string": "", "releaseDev": "", "tmss_case_uri": "", "tmss_feature_uri": "", "activity_id": 1, "tmss_property": { "projectUUId": "fb4a997e9c0d4b13aa0bf230f6f62d53", "type": 1, "asstype": 1, "name": "TestCase_qAlGX_mnlbo_copy", "description": "", "preparation": "", "scriptUrl": "", "steps": [ { "testStep": "", "expectResult": "" } ], "number": "", "level": "2", "moduleId": "", "releaseDev": "", "releaseId": "", "ownerId": "", "test_type": 1, "labelId": [], "issueId": "", "r_issueName": "", "cataId": "", "exe_platform": "apitest", "planId": "" }, "import_info_list": [], "case_variable_list": [], "aw_instance": { "setup_aw_list": [], "test_aw_list": [], "teardown_aw_list": [] }, "source": "cloudtest", "issueId": "", "relate_type": "requirement", "feature_uri": "", "old_tmss_case_uri": "v92s00010hrjv7pg"}"

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 error CommonResponseErrorOfobject object 统一错误返回 reason String 错误原因 result Object 结果 status String 状态值，如success、error 表5 CommonResponseErrorOfobject 参数 参数类型 描述 code String 错误码 reason String 错误原因 状态码：201 Created 状态码：401 表6 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：403 表7 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：404 表8 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串

响应示例 状态码：200 OK { "status" : "success", "result" : { "taskId" : "b98e483aecba4fe3b00b0fe484c391ca", "needApprove" : null, "warn" : [ ], "packageType" : "codearts.testplan.china.pro", "isPopup" : false }, "error" : null}

响应参数 状态码：200 OK 状态码：201 Created 状态码：401 表5 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：403 表6 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：404 表7 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表3 请求Body参数 参数 是否必选 参数类型 描述 cases 否 Array of strings 用例列表 functionType 否 String 执行的功能类型："1"表示执行；"2"表示调试 releaseversion 否 String 发布版本号 resourcePool 否 ResourcePool object 资源池 taskName 否 String 任务名称 表4 ResourcePool 参数 是否必选 参数类型 描述 activeState 否 String 活动状态 id 否 String 唯一标识 name 否 String 名称 selected 否 Boolean 是否被选中 type 否 String 类型

请求示例 { "cases" : [ "v92u000107pd4i0e" ], "taskName" : "taskTestSuite2025/3/10 10:00:49", "releaseversion" : "", "resourcePool" : { "activeState" : "ACTIVE", "id" : "DEFAULT", "type" : "DEFAULT" }, "functionType" : "2"}

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 value String 参数解释 resultObject 取值范围 不涉及 状态码：400 表4 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：401 表5 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：404 表6 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及 状态码：500 表7 响应Body参数 参数 参数类型 描述 code String 参数解释: 业务失败的错误码 取值范围: 不涉及 reason String 参数解释: 业务失败的提示内容 取值范围: 不涉及

响应参数 状态码：201 表3 响应Body参数 参数 参数类型 描述 service_id Integer 参数解释 接口调用成功返回的服务id 取值范围 不涉及 service_name String 参数解释 接口调用成功返回的服务名 取值范围 不涉及 状态码：400 表4 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 不涉及 error_msg String 参数解释 接口调用失败错误信息 取值范围 不涉及 状态码：401 表5 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 不涉及 error_msg String 参数解释 接口调用失败错误信息 取值范围 不涉及 状态码：404 表6 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 不涉及 error_msg String 参数解释 接口调用失败错误信息 取值范围 不涉及 状态码：500 表7 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 不涉及 error_msg String 参数解释 接口调用失败错误信息 取值范围 不涉及

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 主账号用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表2 请求Body参数 参数 是否必选 参数类型 描述 server_host 是 String 参数解释: server_host是由用户提供的域名。我们会通过此域名进行接口调用，测试计划将会通过此域名下的接口，保证服务数据与用户系统数据的一致性。 约束限制: 不涉及 取值范围: 以https/http开头 长度小于等于128位字符。 默认取值: 不涉及 service_name 是 String 参数解释: 测试类型名称，用于界面显示，不能使用当前已有测试类型名称，长度小于等于128。 约束限制: 不涉及 取值范围: 长度小于等于128。 默认取值: 不涉及

请求示例 post https://{{endpoint}}/testrelation/v4/testcases/3fc2130c00/relations{ "relations" : [ { "dr_number" : "3325606", "test_case_uri" : "223685", "relate_type" : "bug/requirement", "resource_type" : "testcase/testitem", "source_system" : "vision", "association_number" : "223685", "region" : "szv" } ], "tracker_id" : "1", "version_uri" : "932opbu6aaf", "task_uri" : "59281152185", "add_to_iterator" : true, "project_uuid" : "223685eqweqwe1112w"}

响应参数 状态码：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 参数解释: 业务失败的提示内容 取值范围: 不涉及

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表3 请求Body参数 参数 是否必选 参数类型 描述 relations 否 Array of RelationInfo objects 参数解释 关联关系 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 tracker_id 否 String 参数解释 工作项类型id 约束限制 1到20位数字 取值范围 不涉及 默认取值 不涉及 version_uri 否 String 参数解释 版本uri 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 task_uri 否 String 参数解释 测试套id 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 add_to_iterator 否 Boolean 参数解释 是否将需求添加到迭代 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 project_uuid 否 String 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制 不涉及 取值范围 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值 不涉及 表4 RelationInfo 参数 是否必选 参数类型 描述 dr_number 是 String 参数解释 需求id 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 test_case_uri 否 String 参数解释 用例uri 约束限制 不涉及 取值范围 11到34位英文或数字 默认取值 不涉及 relate_type 是 String 参数解释 资源类型 约束限制 不涉及 取值范围 bug/requirement 默认取值 不涉及 resource_type 否 String 参数解释 资源类型 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 source_system 否 String 参数解释 来源系统 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 association_number 否 String 参数解释 关联资源编号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 region 否 String 参数解释 逻辑region，外部使用公有云实际区域，内部使用默认值 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及

请求示例 { "name" : "TC_In6gjNEQ_EFfN", "script_name" : "TC_In6gjNEQ_s0rF", "releaseDev" : "", "tmss_case_uri" : "", "tmss_feature_uri" : "", "activity_id" : 1, "tmss_property" : { "name" : "TC_In6gjNEQ_nMv1", "description" : "用例复制", "preparation" : "", "steps" : [ { "testStep" : "", "expectResult" : "" } ], "number" : "", "level" : "2", "moduleId" : "", "releaseDev" : "", "releaseId" : "", "ownerId" : "", "test_type" : 1, "labelId" : [ ], "exe_platform" : "apitest" }, "import_info_list" : [ ], "case_variable_list" : [ ], "aw_instance" : { "setup_aw_list" : [ ], "test_aw_list" : [ ], "teardown_aw_list" : [ ] }, "source" : "cloudtest", "issueId" : "", "old_tmss_case_uri" : "v92s00010hrjv46s"}

响应参数 状态码：200 表25 响应Body参数 参数 参数类型 描述 code String 参数解释 错误码 error CommonResponseErrorObject object 参数解释 统一错误返回 reason String 参数解释 失败原因 result Object 参数解释 结果 status String 参数解释 响应状态 表26 CommonResponseErrorObject 参数 参数类型 描述 code String 参数解释 错误码 reason String 参数解释 错误原因 状态码：201 Created 状态码：401 表27 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：403 表28 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 状态码：404 表29 响应Body参数 参数 参数类型 描述 error_code String 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 error_msg String 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串

URI POST /v3/{project_id}/testcases/copy 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目唯一标识。 约束限制 不涉及 取值范围 32个字符组成的字符串 默认取值 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 des_feature_uri 否 String 目标特性uri iterator_uri 否 String 迭代uri service_id 否 String 服务唯一标识

响应示例 状态码：200 OK { "status" : "success", "result" : { "value" : { "uri" : "v92s00010e7ddfsn", "type" : "TestVersion", "author" : "f3b807a0d249424fa36a0d804110c4ed", "name" : "cxc", "region" : "cn-north-7", "last_modifier" : "f3b807a0d249424fa36a0d804110c4ed", "last_modified" : "2025-04-28 16:42:48", "last_change_time" : "2025-04-28 16:42:48", "version_uri" : "dc3f9aa646ad4707831080d3fcce474d", "parent_uri" : "dc3f9aa646ad4707831080d3fcce474d", "parent_path" : "/dc3f9aa646ad4707831080d3fcce474d/", "creation_version_uri" : "dc3f9aa646ad4707831080d3fcce474d", "creation_date" : "2025-04-28 16:42:48", "is_master" : 0, "is_iterator" : 0, "service_id" : "dc3f9aa646ad4707831080d3fcce474d", "service_name" : "【车联网示例项目】车联网云服务-GJX", "schema_no" : 1, "risk_rating" : 0, "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d" } }}