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

响应参数 状态码： 200 表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 接口调用失败错误信息

请求示例 更新自定义测试服务类型用例 put https://{endpoint}/v1/projects/efdb403066474ab08836b9eeaaa23bca/testcases/1234 { "extend_info" : { "assigned_id" : "b66aab5469cc416hestdda8e644a42a4", "defect_id_list" : [ { "issueId" : "018fd45b181c4f6aa94afac9f769d625", "title" : "缺陷1" }, { "issueId" : "018fd45b181c4f6aa94afac9f769d625", "title" : "缺陷2" }, { "issueId" : "018fd45b181c4f6aa94afac9f769d625", "title" : "缺陷3" } ], "description" : "这是一条描述信息", "fix_version_id" : "1234", "issue_id" : "b66aab5469cc4ab39b0dda8e644a42a4", "label_list" : [ "标签1" ], "module_id" : "b66aab5469cc4ab39b0dda8e644a42a4", "preparation" : "需要满足的前置条件", "status_id" : "0", "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" : "1.1.0.1" }, "name" : "testcase", "rank_id" : "2", "service_id" : 13, "testcase_number" : "1234" }

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

URI PUT /v1/projects/{project_id}/testcases/{testcase_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。 testcase_id 是 String 用例uri,测试用例唯一标识,长度11-34位字符（字母和数字）。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 value Array of IntegerIdAndNameVo objects 测试类型信息 表4 IntegerIdAndNameVo 参数 参数类型 描述 id Integer 数据库存储数字 name String 页面显示值 状态码： 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 业务失败的提示内容

用例管理 在测试用例的详情页，可以进行以下操作： 查看测试用例详情。 单击用例名称查看该用例详细信息。 图1 测试用例详情 编辑测试脚本。 可根据需要添加测试脚本，在测试用例详情页，单击测试脚本后面的“编辑”，编辑脚本类型。 图2 编辑测试脚本 用例发布。 当用例状态为“编辑中”时，用例详情页面，单击用例名称后“发布”，可对用例进行发布。 关闭用例。 当用例状态为“已发布”时，用例详情页面，单击用例名称后“关闭用例”，可对用例进行关闭。 修改用例。 单击用例名称，进入用例详情页，单击右上角“编辑”，即可修改用例信息。 用例状态为＂已关闭＂和＂已发布＂时，不支持编辑用例基本信息。 用例编辑中/发布/关闭的使用逻辑： 测试用例在被创建时的默认状态是编辑中，当测试用例中的场景和测试脚本以及其他相关信息都确认达到测试条件时，可以选择发布测试用例，发布后的测试用例才能被用于创建仿真任务，并且用例一旦发布，就不允许删除，从而保证测试结果的可追溯。当发布后的测试用例后续不会再进行测试时，可以选择关闭测试用例，关闭后的测试用例不能用于创建仿真任务，并且同样关闭后的测试用例不能被删除，从而保证结果的可追溯性。 父主题： 测试用例管理

用例管理 在测试用例的详情页，可以进行以下操作： 查看测试用例详情。 单击用例名称查看该用例详细信息。 图1 测试用例详情 编辑测试脚本。 可根据需要添加测试脚本，在测试用例详情页，单击测试脚本后面的“编辑”，编辑脚本类型。 图2 编辑测试脚本 用例发布。 当用例状态为“编辑中”时，用例详情页面，单击用例名称后“发布”，可对用例进行发布。 关闭用例。 当用例状态为“已发布”时，用例详情页面，单击用例名称后“关闭用例”，可对用例进行关闭。 修改用例。 单击用例名称，进入用例详情页，单击右上角“编辑”，即可修改用例信息。 用例状态为＂已关闭＂和＂已发布＂时，不支持编辑用例基本信息。 用例编辑中/发布/关闭的使用逻辑： 测试用例在被创建时的默认状态是编辑中，当测试用例中的场景和测试脚本以及其他相关信息都确认达到测试条件时，可以选择发布测试用例，发布后的测试用例才能被用于创建仿真任务，并且用例一旦发布，就不允许删除，从而保证测试结果的可追溯。当发布后的测试用例后续不会再进行测试时，可以选择关闭测试用例，关闭后的测试用例不能用于创建仿真任务，并且同样关闭后的测试用例不能被删除，从而保证结果的可追溯性。 父主题： 测试用例管理

提交用例审核 用例设计完成后，用例设计责任人可提交用例设计。如果您的验证流程中跳过了用例审核环节，则可忽略本小节。 用例设计和用例执行等流程可并行执行，即，未评审的用例也可执行，但后续必须评审通过方可提交报告评审。 进入解决方案工作台用例管理界面，点击【提交用例设计】按钮。默认会选择所有待评审的用例，无需手工勾选。 图1 提交用例设计 进入到用例设计的提交页面，勾选要提交审核的用例（如不勾选，则提交所有用例），选择用例审核人后，点击【确定】。用例审核人生成审核待办。 图2 用例设计提交审核页面 用例设计人审核完成后（参考用例审核），用例设计人将收到审核结果的邮件通知（前提：已绑定邮箱订阅），也可以进入需求详情查看审核结果信息。 图3 需求详情页面 用例设计完成评审后，用例设计人可继续编辑用例或新增用例设计。编辑过的或新增的用例为待审核状态，按照上述步骤提交审核即可。 父主题： 用例管理

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 code String 响应码 最小长度：0 最大长度：1024 message String 响应消息 最小长度：0 最大长度：10240 test_case CaseInfoDetail object 用例详情 表3 CaseInfoDetail 参数 参数类型 描述 case_id Integer 用例ID 最小值：0 最大值：2147483647 name String 用例名称 最小长度：0 最大长度：1024 case_type Integer 用例类型（0：常规用例；） 最小值：0 最大值：2147483647 contents Array of Contents objects 用例脚本信息 数组长度：0 - 1024 for_loop_params Array of objects 旧版本逻辑控制器字段，当前已未使用 数组长度：0 - 10240 increase_setting Array of objects 梯度递增 数组长度：0 - 10240 stages Array of TestCaseStage objects 阶段信息 数组长度：0 - 1024 status Integer 状态，0：已删除；1：启用；2：禁用 最小值：0 最大值：2147483647 temp_id Integer 用例ID 最小值：0 最大值：2147483647 sort Integer 排序字段 directory_id Integer 用例所属目录ID（旧版接口可不传） 最小值：0 最大值：2147483647 setup_contents Array of Contents objects 前置步骤 user_replicas Integer 执行器个数 最小值：0 最大值：2147483647 collect_log_policy Integer 日志采集策略（0-请求模式；1-用例模式） 最小值：0 最大值：32 link_app_list Array of integers 关联全链路应用列表 case_info CaseDoc object 文本用例信息 表4 TestCaseStage 参数 参数类型 描述 operate_mode Integer 压力阶段模式，0：时长模式；1：次数模式 name String 阶段名称 time Integer 压测时长（单位：秒） start_time Integer 开始时间 end_time Integer 结束时间 issue_num Integer 最大并发数 count Integer 次数模式发送总次数 pressure_mode Integer 压力模式，0：并发模式；1：TPS模式；2：摸高模式；3：浪涌并发模式；4：浪涌TPS模式；5：震荡并发模式；6：震荡TPS模式；7：智能摸高模式 tps_value Integer TPS模式下TPS值 current_user_num Integer 起始并发数 current_tps Integer 起始TPS值 voltage_regulating_mode Integer 调压模式，0：自动调压模式；1：手动调压模式 maximum Integer 浪涌/浪涌模式下最大并发数 minimum Integer 浪涌/浪涌模式下最小并发数 loop_count Integer 震荡/浪涌次数 max_duration Integer 浪涌模式下峰值持续时间 ramp_up Integer 摸高模式下爬坡时长（单位：秒） peak_load_kpis StageKpiItems object 摸高指标 step_duration Integer 智能摸高模式下单步执行时长 step_size Integer 智能摸高模式下递增并发数 表5 StageKpiItems 参数 参数类型 描述 average_response_time StageKpiItem object 平均响应时间 success_rate StageKpiItem object 成功率 表6 StageKpiItem 参数 参数类型 描述 comparison String 比较符 value Integer 比较值 表7 Contents 参数 参数类型 描述 content_id Integer 事务ID，若不为0表示此卡片为事务；为0表示非事务 最小值：0 最大值：2147483647 content Array of Content objects 内容 数组长度：0 - 1000 index Integer 排序索引标识 最小值：0 最大值：2147483647 selected_temp_name String 选择的事务或者用例名称 最小长度：0 最大长度：40960 data Object 数据（循环、条件控制器作用的数据） data_type Integer 数据指令类型（0：默认请求卡片；1：数据指令；201：循环指令；202：条件指令；301：集合点；203：vu百分比控制器；204：吞吐量控制器；302：插件请求） 最小值：0 最大值：2147483647 conditions Object 若类型为202：条件指令，该字段为条件配置 is_disabled Boolean 是否禁用 表8 Content 参数 参数类型 描述 content_type Integer 用例卡片类型（1：思考时间；2：报文；3：检查点；4：变量提取） 最小值：0 最大值：2147483647 content ContentInfo object 内容 表9 ContentInfo 参数 参数类型 描述 body_type Integer body类型（0：字符串；1：form-data格式；3：x-www-form-urlencoded格式） 最小值：0 最大值：2147483647 bodys Array of objects bodys check_end_length Object TCP/UDP协议返回数据长度 check_end_str Object TCP/UDP协议返回结束符 check_end_type Object TCP/UDP协议返回结束类型，1：返回数据长度；2：结束符 connect_timeout Integer 超时时间 最小值：0 最大值：2147483647 connect_type Integer 连接设置，当前版本已未使用 最小值：0 最大值：2147483647 headers Array of ContentHeader objects 请求头 数组长度：0 - 1024 http_version String HTTP版本 最小长度：0 最大长度：1024 method String HTTP方法 最小长度：0 最大长度：1024 name String 用例名称 最小长度：0 最大长度：1024 protocol_type Integer 协议类型（1：HTTP；2：HTTPS；3：TCP；4：UDP；7：HLS/RTMP；9：WebSocket；10：HTTP-FLV） 最小值：0 最大值：2147483647 return_timeout Integer 响应超时 最小值：0 最大值：2147483647 return_timeout_param String 响应超时参数 最小长度：0 最大长度：40960 url String 请求地址 最小长度：0 最大长度：40960 rtmp_url String rtmp地址 最小长度：0 最大长度：40960 flv_url String flv地址 最小长度：0 最大长度：40960 bitrate_type Integer 分辨率策略 最小值：0 最大值：128 duration Integer 持续时间 最小值：0 最大值：2147483647 retry_delay Integer HLS重试延迟时间 最小值：0 最大值：2147483647 retry_time Integer HLS重试次数 最小值：0 最大值：2147483647 表10 ContentHeader 参数 参数类型 描述 key String 键 最小长度：0 最大长度：40960 value String 值 最小长度：0 最大长度：40960 表11 CaseDoc 参数 参数类型 描述 description String 用例描述信息 最小长度：0 最大长度：2147483647 label_names Array of strings 标签 preparation String 前置条件 最小长度：0 最大长度：2147483647 rank Integer 用例等级（0-L0；1-L1；2-L2；3-L3；4-L4；） 最小值：0 最大值：64 status_code Integer 状态（0-新建；5-设计中；6-测试中；7-完成；） steps Array of steps objects 测试步骤 表12 steps 参数 参数类型 描述 expect_result String 步骤描述 最小长度：0 最大长度：2147483647 test_step String 预期结果 最小长度：0 最大长度：2147483647

操作步骤 登录性能测试服务控制台，在左侧导航栏中选择“PerfTest测试工程”。 在待编辑PerfTest测试工程所在行，单击工程名称进入测试工程详情页面。 选择“测试用例”页签，可以在页面左侧查看当前已创建的用例目录结构。可以通过以下两种方式创建用例： 在当前目录下创建用例：直接单击“创建用例”。 图1 在当前目录下创建用例 在指定目录下创建用例：将鼠标光标放置在指定目录上，单击，在下拉框中选择“创建用例”。 图2 在指定目录下创建用例 单击“保存”。

自定义请求 在测试用例中，可能需要调用项目之外的接口，例如在请求华为终端app前，需要调用账号服务的获取用户认证token。此时用户可以在测试步骤中添加自定义请求，自定义请求可以是任何 HTTP 请求，包括常见的 GET、POST、PUT、DELETE 等请求。 单击“URL请求”选项，添加“自定义URL请求”测试步骤。 在自定义请求中可编辑请求名称、地址和请求参数等信息，详细参照设置接口请求章节。

从postman文件导入 接口自动化测试用例支持通过导入Postman文件，生成测试步骤。 导入Postman文件需满足以下要求： 支持Postman Collection v2.1标准。 仅支持Postman请求方法、请求URL、请求头、请求体生成测试步骤。 Postman请求体导入方式仅支持form-data、x-www-form-urlencode、raw。 Postman请求体form-data上传附件需要在测试步骤中单独上传。 单击“Postman”，弹出“导入Postman Colection文件”对话框。 上传需要导入的postman文件,单击“确定”，导入postman请求文件，完成测试步骤添加。

从接口/接口用例导入 用户可以将API设计的数据导入测试步骤，主要有两个来源：“从【接口用例】导入（推荐）”和“从【接口】导入”。 从【接口用例】导入（推荐） 在弹出的“从【接口用例】导入（推荐）”对话框上，选择需要导入的接口，即“API设计”中接口的调试用例，参考保存为用例。 单击“导入”，完成测试步骤添加。 从【接口】导入 在弹出的“从【接口】导入”对话框上，选择需要导入的接口，即“API设计”的接口数据。 单击“导入”，完成测试步骤添加。

从接口/接口用例导入 用户可以将API设计的数据导入测试步骤，主要有两个来源：“从【接口用例】导入（推荐）”和“从【接口】导入”。 从【接口用例】导入（推荐） 在弹出的“从【接口用例】导入（推荐）”对话框上，选择需要导入的接口，即“API设计”中接口的调试用例，参考保存为用例。 单击“导入”，完成测试步骤添加。 从【接口】导入 在弹出的“从【接口】导入”对话框上，选择需要导入的接口，即“API设计”的接口数据。 单击“导入”，完成测试步骤添加。