# 在分支或者测试计划下创建用例 - CreateVersionTestCase #### 功能介绍 此接口用于在分支或者测试计划下创建用例，同页面 测试 -\> 测试用例 -\> 右侧展示用例列表，上方任务栏可筛选分支 -\> 筛选分支，点击下方新建用例 -\> 填写必填值后，点击保存 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /GT3KServer/v4/versions/{version_id}/testcases 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | version_id | 是 | String | **参数解释**: 分支或者迭代uri **约束限制**: 不涉及 **取值范围**: 0-32位英文或数字 **默认取值**: 不涉及 **获取方法**： 从GET /v4/projects/{project_id}/iterator-infos的返回字段获取 从GET /v1/{project_id}/branches 的返回字段获取 | #### 请求参数 表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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | case_uri | 否 | String | **参数解释** 用例的主键 **约束限制** 长度限制32字符 **取值范围** 不涉及 **默认取值** 不涉及 | | attachments | 否 | Array of [TestCaseAttachmentInfo] objects | **参数解释**: 对外附件 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及 | | steps | 否 | Array of [TestCaseStepInfo] objects | **参数解释**: 测试步骤 **约束限制**: 不涉及 **取值范围**: 0-100 **默认取值**: 不涉及 | | author | 否 | String | **参数解释** 创建人 **约束限制** 1-32个英文或者数字 **取值范围** 不涉及 **默认取值** 不涉及 | | name | 是 | String | **参数解释** 名称 **约束限制** 长度限制128字符 **取值范围** 不涉及 **默认取值** 不涉及 | | rank | 是 | Integer | **参数解释** 用例等级 **约束限制** 不涉及 **取值范围** 取值范围：0,1,2,3,4 **默认取值** 不涉及 | | owner | 否 | String | **参数解释** 处理人 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | preparation | 否 | String | **参数解释** 前置条件 **约束限制** 长度限制3000字符 **取值范围** 不涉及 **默认取值** 不涉及 | | remark | 否 | String | **参数解释** 备注 **约束限制** 不涉及 **取值范围** 不超过20000字符 **默认取值** 不涉及 | | stage | 否 | String | **参数解释** 测试阶段 **约束限制** 长度限制50字符 **取值范围** 不涉及 **默认取值** 不涉及 | | activity | 否 | String | **参数解释** 测试类型 **约束限制** 长度限制64字符 **取值范围** 不涉及 **默认取值** 不涉及 | | keywords | 否 | String | **参数解释** 关键词 **约束限制** 长度限制512字符 **取值范围** 不涉及 **默认取值** 不涉及 | | market | 否 | String | **参数解释** apitest标记是否代码已提交 **约束限制** 长度限制1024字符 **取值范围** 不涉及 **默认取值** 不涉及 | | designer | 否 | String | **参数解释** 设计者 **约束限制** 长度限制64字符 **取值范围** 不涉及 **默认取值** 不涉及 | | tags | 否 | String | **参数解释** 标签 **约束限制** 长度限制512字符 **取值范围** 不涉及 **默认取值** 不涉及 | | region | 否 | String | **参数解释** 逻辑region，外部使用公有云实际区域，内部使用默认值 **约束限制** 长度限制32字符 **取值范围** 不涉及 **默认取值** 不涉及 | | relate_type | 否 | String | **参数解释**: 关联关系类型 **约束限制**: 不涉及 **取值范围**: - bug，缺陷。 - requirement，需求。 **默认取值**: 不涉及 | | service_type | 是 | Integer | **参数解释**: 服务类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 **默认取值**: 不涉及 | | only_change_script | 否 | String | **参数解释** 更新接口用例的java脚本路径标识 **约束限制** 长度限制32字符 **取值范围** 不涉及 **默认取值** 不涉及 | | add_to_iterator | 否 | String | **参数解释** 需求添加到迭代标识 **约束限制** 长度限制5字符 **取值范围** 不涉及 **默认取值** 不涉及 | | need_update_relation | 否 | String | **参数解释** 是否修改关联关系 **约束限制** 长度限制5字符 **取值范围** 不涉及 **默认取值** 不涉及 | | creation_version_uri | 否 | String | **参数解释** 创建版本Uri **约束限制** 11到34位英文或数字 **取值范围** 不涉及 **默认取值** 不涉及 | | number | 否 | String | **参数解释** 用例编号 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | case_type | 否 | Integer | **参数解释**: 用例类型 **约束限制**: 不涉及 **取值范围**: - 0，手工测试。 - 1，接口自动化。 - 2，性能用例。 **默认取值**: 不涉及 | | platform_type | 否 | Integer | **参数解释** 执行平台类型 **约束限制** 不涉及 **取值范围** 取值范围：-128-127 **默认取值** 不涉及 | | test_type | 否 | Integer | **参数解释**: 测试类型 **取值范围**: - 1，功能性测试。 - 2，兼容性测试。 - 4，性能测试。 - 15，易用性测试。 - 22，可靠性测试。 - 14，安全性测试。 - 21，可服务性测试。 | | design_note | 否 | String | **参数解释** 设计描述 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | test_step | 否 | String | **参数解释** 测试步骤 **约束限制** 长度限制250000字符 **取值范围** 不涉及 **默认取值** 不涉及 | | expect_output | 否 | String | **参数解释** 期望结果 **约束限制** 长度限制250000字符 **取值范围** 不涉及 **默认取值** 不涉及 | | env_type | 否 | String | **参数解释** 测试环境类型 **约束限制** 长度限制512字符 **取值范围** 不涉及 **默认取值** 不涉及 | | exe_platform | 否 | String | **参数解释** 执行平台 **约束限制** 长度限制200字符 **取值范围** 不涉及 **默认取值** 不涉及 | | testcase_project | 否 | String | **参数解释** 测试工程 **约束限制** 长度限制1024字符 **取值范围** 不涉及 **默认取值** 不涉及 | | svn_script_path | 否 | String | **参数解释** 脚本路径 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | map_restrict | 否 | String | **参数解释** 约束条件 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | network_script_name | 否 | String | **参数解释** 网络脚本名 **约束限制** 长度限制500字符 **取值范围** 不涉及 **默认取值** 不涉及 | | auto_type | 否 | Integer | **参数解释**: 自动化类型 **约束限制**: 不涉及 **取值范围**: - 0，非自动化。 - 1，是自动化。 **默认取值**: 不涉及 | | to_be_auto_exec | 否 | Integer | **参数解释** 被自动化执行 **约束限制** 不涉及 **取值范围** -128-127 **默认取值** 不涉及 | | last_result | 否 | String | **参数解释** 最后一次结果 **约束限制** 长度限制16字符 **取值范围** 不涉及 **默认取值** 不涉及 | | last_result_uri | 否 | String | **参数解释** 最后一次结果Uri **约束限制** 不涉及 **取值范围** 11-34位数字或英文 **默认取值** 不涉及 | | feature_uri | 否 | String | **参数解释** 目录Uri **约束限制** 不涉及 **取值范围** 11-34位数字或英文 **默认取值** 不涉及 | | interface_name | 否 | String | **参数解释** 测试接口名 **约束限制** 长度限制200字符 **取值范围** 不涉及 **默认取值** 不涉及 | | snp_no | 否 | String | **参数解释** 网络问题ID **约束限制** 长度限制500字符 **取值范围** 不涉及 **默认取值** 不涉及 | | dr_relation_id | 否 | String | **参数解释** 关联需求编号 **约束限制** 不涉及 **取值范围** 1-32位数字 **默认取值** 不涉及 | | test_base_num | 否 | String | **参数解释** 测试基数 **约束限制** 长度限制200字符 **取值范围** 不涉及 **默认取值** 不涉及 | | automatically_executed | 否 | Integer | **参数解释** 是否被自动化执行 **约束限制** 不涉及 **取值范围** -128-127 **默认取值** 不涉及 | | first_execute_time | 否 | String | **参数解释** 第一次执行时间 **约束限制** d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2} **取值范围** 不涉及 **默认取值** 不涉及 | | detect_type | 否 | String | **参数解释** 检测类型 **约束限制** 长度限制100字符 **取值范围** 不涉及 **默认取值** 不涉及 | | execute_param | 否 | String | **参数解释** 执行参数 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | test_feature | 否 | String | **参数解释** 分析领域 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | is_contract_testcase | 否 | Integer | **参数解释** 是否是契约用例，0:表示非契约用例, 1：表示契约用例 **约束限制** 不涉及 **取值范围** 0,1 **默认取值** 不涉及 | | time_cost | 否 | Double | **参数解释** 总共耗时 **约束限制** 不涉及 **取值范围** 2147483648.44-2147483647.44 **默认取值** 不涉及 | | custom_field_1 | 否 | String | **参数解释** 自定义字段1 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_2 | 否 | String | **参数解释** 自定义字段2 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_3 | 否 | String | **参数解释** 自定义字段3 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_4 | 否 | String | **参数解释** 自定义字段4 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_5 | 否 | String | **参数解释** 自定义字段5 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_6 | 否 | String | **参数解释** 自定义字段6 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_7 | 否 | String | **参数解释** 自定义字段7 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_8 | 否 | String | **参数解释** 自定义字段8 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_9 | 否 | String | **参数解释** 自定义字段9 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_10 | 否 | String | **参数解释** 自定义字段10 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_11 | 否 | String | **参数解释** 自定义字段11 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_12 | 否 | String | **参数解释** 自定义字段12 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_13 | 否 | String | **参数解释** 自定义字段13 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_14 | 否 | String | **参数解释** 自定义字段14 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_15 | 否 | String | **参数解释** 自定义字段15 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_16 | 否 | String | **参数解释** 自定义字段16 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_17 | 否 | String | **参数解释** 自定义字段17 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_18 | 否 | String | **参数解释** 自定义字段18 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_19 | 否 | String | **参数解释** 自定义字段19 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_20 | 否 | String | **参数解释** 自定义字段20 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_21 | 否 | String | **参数解释** 自定义字段21 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_22 | 否 | String | **参数解释** 自定义字段22 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_23 | 否 | String | **参数解释** 自定义字段23 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_24 | 否 | String | **参数解释** 自定义字段24 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | custom_field_25 | 否 | String | **参数解释** 自定义字段25 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | be_auto_type_time | 否 | String | **参数解释** 记录用例由非自动化变为自动化类型的时间 **约束限制** d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2} **取值范围** 不涉及 **默认取值** 不涉及 | | compare_number | 否 | String | **参数解释** 配对用例编号 **约束限制** 长度限制100字符 **取值范围** 不涉及 **默认取值** 不涉及 | | scene_flag | 否 | String | **参数解释** 场景标识 **约束限制** 长度限制50字符 **取值范围** 不涉及 **默认取值** 不涉及 | | base_flag | 否 | String | **参数解释** 场景标识 **约束限制** 长度限制50字符 **取值范围** 不涉及 **默认取值** 不涉及 | | para_validator | 否 | String | **参数解释** 区别是否从yaml中生成的用例，默认false **约束限制** 长度限制50字符 **取值范围** 不涉及 **默认取值** false | | knet_node_id | 否 | String | **参数解释** knet节点id **约束限制** 长度限制50字符 **取值范围** 不涉及 **默认取值** 不涉及 | | last_exe_author | 否 | String | **参数解释** 最后一次执行用户 **约束限制** 长度限制50字符 **取值范围** 不涉及 **默认取值** 不涉及 | | cloud_carrier | 否 | String | **参数解释** 运营商 **约束限制** 长度限制100字符 **取值范围** 不涉及 **默认取值** 不涉及 | | market_place | 否 | String | **参数解释** 应用市场 **约束限制** 长度限制1024字符 **取值范围** 不涉及 **默认取值** 不涉及 | | test_mind_id | 否 | String | **参数解释** 脑图id **约束限制** 长度限制256字符 **取值范围** 不涉及 **默认取值** 不涉及 | | test_mind_url | 否 | String | **参数解释** 脑图url **约束限制** 长度限制1024字符 **取值范围** 不涉及 **默认取值** 不涉及 | | commit_url | 否 | String | **参数解释** git提交url **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | test_pattern_number | 否 | String | **参数解释** 测试模式编号 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | test_factor_number | 否 | String | **参数解释** 测试因子编号 **约束限制** 长度限制65535字符 **取值范围** 不涉及 **默认取值** 不涉及 | | status_code | 否 | String | **参数解释** 状态Code **约束限制** \[-\]?\[0-9\]{1,5} **取值范围** 不涉及 **默认取值** 不涉及 | | result_code | 否 | String | **参数解释** 测试因子编号 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | release_id | 否 | String | **参数解释** 迭代ID **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | label_id | 否 | String | **参数解释** 标签ID **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | label_names | 否 | Array of strings | **参数解释** 用例操作时，标签名列表 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | module_id | 否 | String | **参数解释** 模块ID **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | execute_latest_time | 否 | String | **参数解释** 最后执行时间 **约束限制** 不涉及 **取值范围** 格式为yyyy-MM-dd HH:mm:ss **默认取值** 不涉及 | | execute_duration | 否 | String | **参数解释** 执行时长 **约束限制** 不涉及 **取值范围** 单位（毫秒） **默认取值** 不涉及 | | is_keyword | 否 | Integer | **参数解释** 是否关键用例 **约束限制** 不涉及 **取值范围** -128-127 **默认取值** 不涉及 | | release_dev | 否 | String | **参数解释** 测试版本号 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | new_created | 否 | Integer | **参数解释** 是否用户新增用例 **约束限制** 不涉及 **取值范围** -128-127 **默认取值** 不涉及 | | execute_parameter | 否 | String | **参数解释** 执行参数 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | project_uuid | 是 | String | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | version_uri | 否 | String | **参数解释** 分支或者迭代uri **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | 表4TestCaseAttachmentInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | override | 否 | Boolean | **参数解释** 附件是否要被覆盖 **约束限制** 不涉及 **取值范围** true\|false **默认取值** 不涉及 | | doc_id | 否 | String | **参数解释** 文档id **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | file_name | 是 | String | **参数解释** 文件名 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | file_path | 否 | String | **参数解释** 文件路径 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | file_type | 否 | String | **参数解释**: 文件类型 **约束限制**: 根据文件后缀扩展名填入 **取值范围**: - txt，文本文件。 - img，图片文件。 等等 **默认取值**: 不涉及 | | file_size | 否 | String | **参数解释** 文件大小 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | override_id | 否 | String | **参数解释** 重复用例ID **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | related_type | 否 | String | **参数解释**: 相关类型 **约束限制**: 不涉及 **取值范围**: - 0，本地上传。 - 1，关联文档。 **默认取值**: 不涉及 | | store_file_name | 否 | String | **参数解释** 保存文件名 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | system_type | 否 | String | **参数解释**: 系统类型 **约束限制**: 根据系统类型传入对应的值 **取值范围**: - docman，docman系统。 - testman，testman系统。 **默认取值**: 不涉及 | | storage_system | 否 | String | **参数解释** 区分文件存储系统 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | 表5TestCaseStepInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | test_step | 否 | String | **参数解释** 测试步骤 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | expect_result | 否 | String | **参数解释** 预期结果 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | step_actual | 否 | String | **参数解释** 步骤的实际结果 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | step_result | 否 | String | **参数解释** 步骤结果 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | #### 响应参数 **状态码：200** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | [TestCaseVo] object | **参数解释**: 请求返回的结果 **取值范围**: 不涉及 | 表7TestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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_id | String | **参数解释** 创建人ID **取值范围** 不涉及 | | 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_id | String | **参数解释** 工作项id **取值范围** 不涉及 | | issue_tracker_id | String | **参数解释** 工作项类型id **取值范围** 不涉及 | | issue_assign_status | String | **参数解释** 工作项分配状态 **取值范围** 不涉及 | | issue_name | String | **参数解释** 需求名称 **取值范围** 不涉及 | | issue_design_owner | String | **参数解释** 工作项设计责任人 **取值范围** 不涉及 | | issue_design_owner_d | String | **参数解释** 工作项设计责任人id **取值范围** 不涉及 | | tracker_name | String | **参数解释** 工作项类型名称 **取值范围** 不涉及 | | defect_list | Array of [NameAndId] objects | **参数解释** 缺陷列表 **取值范围** 不涉及 | | result_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 | **参数解释** 用例标签名称列表 **取值范围** 不涉及 | | status_name | 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](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 长度等于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 **取值范围** 不涉及 | 表8NameAndId | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**: 对象编号 **取值范围**: 11-34位的字母及数字（字符串） | | name | String | **参数解释**: 对象名称 **取值范围**: 不涉及 | **状态码：400** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：401** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：404** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：500** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | #### 请求示例 ``` post https://{endpoint}/GT3KServer/v4/versions/v92s00010db209le/testcases { "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d", "version_uri" : "v92s00010db209le", "service_type" : 0, "relate_type" : "requirement", "name" : "新建的测试用例", "remark" : "", "preparation" : "", "svn_script_path" : "", "steps" : [ { "test_step" : "", "expect_result" : "" } ], "number" : "", "rank" : 2, "module_id" : "", "release_dev" : "", "release_id" : "", "owner" : "", "test_type" : 1, "label_names" : [ ], "dr_relation_id" : "", "attachments" : [ { "file_name" : "版本搬迁_sourcePaths.txt" } ] } ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "uri" : "v92t00010e7buhie", "type" : "TestCase", "author" : "f3b807a0d249424fa36a0d804110c4ed", "name" : "新建的测试用例", "rank" : 2, "stage" : "1", "designer" : "f3b807a0d249424fa36a0d804110c4ed", "region" : "cn-north-7", "last_modifier" : "f3b807a0d249424fa36a0d804110c4ed", "last_modified" : "2025-04-28 16:17:09", "last_change_time" : "2025-04-28 16:17:09", "version_uri" : "v92s00010db208e5", "parent_uri" : "v92s00010db208e5", "parent_path" : "/dc3f9aa646ad4707831080d3fcce474d/v92s00010db208e5/", "creation_version_uri" : "v92s00010db208e5", "creation_date" : "2025-04-28 16:17:09", "number" : "102", "case_type" : 0, "platform_type" : 0, "service_type" : 0, "test_type" : 1, "test_step" : "[\"\"]", "expect_output" : "[\"\"]", "auto_type" : 0, "to_be_auto_exec" : 0, "automatically_executed" : 0, "is_contract_testcase" : 0, "time_cost" : 0, "status_code" : "0", "execute_times" : 0, "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d", "creation_version_name" : "基线" } } ``` #### SDK代码示例 SDK代码示例如下。 #### Java ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cloudtest.v1.region.CloudtestRegion; import com.huaweicloud.sdk.cloudtest.v1.*; import com.huaweicloud.sdk.cloudtest.v1.model.*; import java.util.List; import java.util.ArrayList; public class CreateVersionTestCaseSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); CloudtestClient client = CloudtestClient.newBuilder() .withCredential(auth) .withRegion(CloudtestRegion.valueOf("")) .build(); CreateVersionTestCaseRequest request = new CreateVersionTestCaseRequest(); request.withVersionId("{version_id}"); TestCaseInfo body = new TestCaseInfo(); List listbodyAttachments = new ArrayList<>(); listbodyAttachments.add( new TestCaseAttachmentInfo() .withFileName("版本搬迁_sourcePaths.txt") ); List listbodySteps = new ArrayList<>(); listbodySteps.add( new TestCaseStepInfo() .withTestStep("") .withExpectResult("") ); body.withVersionUri("v92s00010db209le"); body.withProjectUuid("dc3f9aa646ad4707831080d3fcce474d"); body.withReleaseDev(""); body.withModuleId(""); body.withReleaseId(""); body.withDrRelationId(""); body.withSvnScriptPath(""); body.withTestType(1); body.withNumber(""); body.withServiceType(0); body.withRelateType("requirement"); body.withRemark(""); body.withPreparation(""); body.withOwner(""); body.withRank(2); body.withName("新建的测试用例"); body.withAttachments(listbodyAttachments); body.withSteps(listbodySteps); request.withBody(body); try { CreateVersionTestCaseResponse response = client.createVersionTestCase(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` #### Python ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcloudtest.v1.region.cloudtest_region import CloudtestRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcloudtest.v1 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] credentials = BasicCredentials(ak, sk) client = CloudtestClient.new_builder() \ .with_credentials(credentials) \ .with_region(CloudtestRegion.value_of("")) \ .build() try: request = CreateVersionTestCaseRequest() request.version_id = "{version_id}" listAttachmentsbody = [ TestCaseAttachmentInfo( file_name="版本搬迁_sourcePaths.txt" ) ] listStepsbody = [ TestCaseStepInfo( test_step="", expect_result="" ) ] request.body = TestCaseInfo( version_uri="v92s00010db209le", project_uuid="dc3f9aa646ad4707831080d3fcce474d", release_dev="", module_id="", release_id="", dr_relation_id="", svn_script_path="", test_type=1, number="", service_type=0, relate_type="requirement", remark="", preparation="", owner="", rank=2, name="新建的测试用例", attachments=listAttachmentsbody, steps=listStepsbody ) response = client.create_version_test_case(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` #### Go ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cloudtest "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cloudtest.CloudtestClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cloudtest.NewCloudtestClient(hcClient) request := &model.CreateVersionTestCaseRequest{} request.VersionId = "{version_id}" fileNameAttachments:= "版本搬迁_sourcePaths.txt" var listAttachmentsbody = []model.TestCaseAttachmentInfo{ { FileName: &fileNameAttachments, }, } testStepSteps:= "" expectResultSteps:= "" var listStepsbody = []model.TestCaseStepInfo{ { TestStep: &testStepSteps, ExpectResult: &expectResultSteps, }, } versionUriTestCaseInfo:= "v92s00010db209le" projectUuidTestCaseInfo:= "dc3f9aa646ad4707831080d3fcce474d" releaseDevTestCaseInfo:= "" moduleIdTestCaseInfo:= "" releaseIdTestCaseInfo:= "" drRelationIdTestCaseInfo:= "" svnScriptPathTestCaseInfo:= "" testTypeTestCaseInfo:= int32(1) numberTestCaseInfo:= "" serviceTypeTestCaseInfo:= int32(0) relateTypeTestCaseInfo:= "requirement" remarkTestCaseInfo:= "" preparationTestCaseInfo:= "" ownerTestCaseInfo:= "" rankTestCaseInfo:= int32(2) request.Body = &model.TestCaseInfo{ VersionUri: &versionUriTestCaseInfo, ProjectUuid: &projectUuidTestCaseInfo, ReleaseDev: &releaseDevTestCaseInfo, ModuleId: &moduleIdTestCaseInfo, ReleaseId: &releaseIdTestCaseInfo, DrRelationId: &drRelationIdTestCaseInfo, SvnScriptPath: &svnScriptPathTestCaseInfo, TestType: &testTypeTestCaseInfo, Number: &numberTestCaseInfo, ServiceType: &serviceTypeTestCaseInfo, RelateType: &relateTypeTestCaseInfo, Remark: &remarkTestCaseInfo, Preparation: &preparationTestCaseInfo, Owner: &ownerTestCaseInfo, Rank: &rankTestCaseInfo, Name: "新建的测试用例", Attachments: &listAttachmentsbody, Steps: &listStepsbody, } response, err := client.CreateVersionTestCase(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` #### 更多 更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CloudTest/sdk?api=CreateVersionTestCase)的代码示例页签，可生成自动对应的SDK代码示例。 #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。