云服务器内容精选

  • URI GET /v4/{project_id}/tasks/{task_uri}/results/{result_uri} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id,对应"需求管理 CodeArts Req"项目唯一标识,测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字 默认取值: 不涉及 task_uri 是 String 任务URI result_uri 是 String 测试任务结果URI 表2 Query参数 参数 是否必选 参数类型 描述 page_no 否 Integer 页码 page_size 否 Integer 页大小 result 否 String 结果过滤条件
  • 响应示例 状态码: 200 OK { "status" : "success", "result" : { "total" : 1, "value" : { "owner" : "xxx", "total" : 1, "case_result_statics" : { "未执行" : 1 }, "task_result" : { "uri" : "v9220000vrphja3d", "name" : "手工测试", "description" : "", "creator" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "updator" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "task_uri" : "v91k0000vrphio4t", "version_uri" : "v91j0000vldleodb", "creator_name" : "xxx", "create_time" : "2024-09-11 14:43:58", "create_time_timestamp" : 1726037038000, "update_time" : "2024-09-11 14:44:30", "update_time_timestamp" : 1726037070000, "start_time" : "2024-09-11 14:43:58", "start_time_timestamp" : 1726037038000, "end_time" : "2024-09-11 14:43:58", "end_time_timestamp" : 1726037038000, "result_code" : 0, "result_name" : "成功", "finish_flg" : 0, "project_uuid" : "300c6295a54c4c698608c878f47ddd59" }, "test_result_list" : [ { "steps" : [ ], "test_case_uri" : "v91k0000vrph3iv9", "test_case_name" : "testcase01", "result_name" : "未执行", "time_cost" : 0, "test_case_number" : "42099" } ], "finish_count" : 0 }, "page_size" : 10, "page_no" : 1 } }
  • 创建测试套件 自动化测试套件,实现用例串行/并行执行的策略,测试用例分块加速能力,有效提高资源池利用率,减少任务阻塞情况。并且可提前拦截产品缺陷,更加快速地发现问题。 可通过以下两种入口新建测试套件。 入口一:单击主页面的“新建测试套件”选项。 入口二:单击左侧测试用例旁边的,选择下拉选项中的“新建测试套件”选项。 在“新建测试套件”页面,填写用例名称与描述。 单击,弹出“添加测试用例”对话框,选择需要添加到测试套件的测试用例,单击“确定”。 单击,弹出“执行策略”对话框,根据需要配置执行策略,单击“确定”。 定时类型:执行一次、周期性重复执行,周期性指设置一个执行频率,测试套按照这个频率周期重复执行。 任务开始时间:立即执行、指定开始时间。 执行时间区间:全天执行、指定执行区间,即指定套件执行的时间段。 用例超时时间:设置每个用例的最长执行时间,超过时间,用例则超时失败。 任务继续执行,直到最后一个用例执行完毕。可设置分钟级,小时级,天级。 回到当前测试套件页面,单击右上角“保存“,完成自动化测试套件创建。 父主题: 测试套件管理
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 value TaskListVo object 实际的数据类型:单个对象,集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表5 TaskListVo 参数 参数类型 描述 tasks Array of TaskVo objects 测试任务集合 running_count Integer 正在执行任务数 表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 编码 状态码: 400 表10 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 401 表11 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 404 表12 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 500 表13 响应Body参数 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容
  • URI POST /GT3KServer/v4/{project_id}/versions/{version_id}/tasks/batch-query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目id,对应"需求管理 CodeArts Req"项目唯一标识,测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字 默认取值: 不涉及 version_id 是 String 版本URI
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 uris 否 Array of strings 测试任务URI集合 keyword 否 String 关键字查询,任务名或编号 tags 否 Array of strings 标签集合 own 否 Boolean 是否是我的 service_type 否 Integer 服务类型 release_dev_list 否 Array of strings 发布版本号集合 result_codes 否 Array of strings 结果Code集合 status_codes 否 Array of strings 状态Code集合 owner_ids 否 Array of strings 责任人ID集合 executor_ids 否 Array of strings 执行者ID集合 creator_ids 否 Array of strings 创建者ID集合 sort_field 否 String 排序字段 sort_type 否 String 排序方式 page_no 否 Integer 当前页数 page_size 否 Integer 每页条数 is_polling_query 否 Boolean 是否轮询查询 is_query_associated_case_list 否 Boolean 是否获取关联用例列表 plan_start_start_timestamp 否 Long 计划开始时间过滤起始时间戳 plan_start_end_timestamp 否 Long 计划开始时间过滤结束时间戳 plan_end_start_timestamp 否 Long 计划结束时间过滤起始时间戳 plan_end_end_timestamp 否 Long 计划结束时间过滤结束时间戳 expiration_status_list 否 Array of integers 测试套超期状态过滤,超期状态值分别为:无状态(null)、未超期(0)、即将超期(1)、已超期(2)、延期完成(3)、按期完成(4)
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 status String success|error result ResultValueExecuteTaskVo object 请求的返回的数据对象 error ApiError object 失败时的error信息 request_id String 由接口调用方传入,建议使用UUID保证请求的唯一性。 server_address String 本次请求的受理的服务地址。 表4 ResultValueExecuteTaskVo 参数 参数类型 描述 total Integer 起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 value ExecuteTaskVo object 实际的数据类型:单个对象,集合 或 NULL reason String 业务失败的提示内容 page_size Integer 每页展示条数 page_no Integer 页码 has_more Boolean 是否有更多 表5 ExecuteTaskVo 参数 参数类型 描述 flag Boolean 标志 uri String URI task_result_vo TaskResultVo object 实际的数据类型:单个对象,集合 或 NULL update_case_uri_list Array of strings 更新用例 test_case_result_list Array of TestResultVo objects 用例结果列表 表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_id String 项目id 表7 TestResultVo 参数 参数类型 描述 uri String 结果URI name String 用例结果名称 author String 创建人ID rank Integer 级别 result Integer 测试结果Code round Integer 执行批次 preparation String 前置条件 description String 描述 region String 逻辑Region steps Array of ResultStepVo objects 测试步骤信息 number String 用例结果编号 author_name String 创建人名称 begin_time String 执行开始时间 begin_time_timestamp Long 执行开始时间时间戳 end_time String 执行结束时间 end_time_timestamp Long 执行结束时间时间戳 creation_date String 创建时间 creation_date_timestamp Long 创建时间时间戳 last_modified String 最后修改时间 last_modified_timestamp Long 最后修改时间 last_change_time String 最后变更时间 last_change_time_timestamp Long 最后变更时间 dfx_test_result String DFX测试结果 failure_cause String 失败原因 parent_uri String 父节点URI(分支用例URI或迭代用例URI) test_case_uri String 分支用例URI test_case_name String 用例名称 task_uri String 测试任务URI result_name String 测试结果 test_result_ae String 是否自动化执行 executor_id String 执行人ID executor_name String 执行人名称 task_id String 执行机任务ID execute_id String 执行ID time_cost Integer 执行耗时 step_txt String 测试步骤 step_expect String 测试步骤期望结果 step_actual String 测试步骤实际结果 step_result String 测试步骤结果 release_dev String 版本号 creation_version_uri String 创建版本URI version_uri String 版本URI project_id String 项目ID report_url String 第三方过来的执行结果,返回跳转到第三方的url test_case_number String 测试用例编号 service_type String 测试类型 表8 ResultStepVo 参数 参数类型 描述 result String 结果 test_step String 测试步骤 expect_result String 预期结果 actual_result String 实际结果 result_name String 测试结果名称 表9 ApiError 参数 参数类型 描述 code String 业务失败的错误码 reason String 业务失败的提示内容 状态码: 400 表10 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 401 表11 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 404 表12 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息 状态码: 500 表13 响应Body参数 参数 参数类型 描述 error_code String 接口调用失败错误码 error_msg String 接口调用失败错误信息
  • 创建测试套件 自动化测试套件,实现用例串行/并行执行的策略,测试用例分块加速能力,有效提高资源池利用率,减少任务阻塞情况。并且可提前拦截产品缺陷,更加快速地发现问题。 可通过以下两种入口新建测试套件。 入口一:单击主页面的“新建测试套件”选项。 入口二:单击左侧测试用例旁边的,选择下拉选项中的“新建测试套件”选项。 在“新建测试套件”页面,填写用例名称与描述。 单击,弹出“添加测试用例”对话框,选择需要添加到测试套件的测试用例,单击“确定”。 单击,弹出“执行策略”对话框,根据需要配置执行策略,单击“确定”。 定时类型:执行一次、周期性重复执行,周期性指设置一个执行频率,测试套按照这个频率周期重复执行。 任务开始时间:立即执行、指定开始时间。 执行时间区间:全天执行、指定执行区间,即指定套件执行的时间段。 用例超时时间:设置每个用例的最长执行时间,超过时间,用例则超时失败。 任务继续执行,直到最后一个用例执行完毕。可设置分钟级,小时级,天级。 回到当前测试套件页面,单击右上角“保存“,完成自动化测试套件创建。 父主题: 测试套件管理