更新时间:2024-11-19 GMT+08:00
分享

获取测试套任务详情

功能介绍

获取测试套任务详情

URI

GET /v4/{project_id}/tasks/{task_uri}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目id,对应"需求管理 CodeArts Req"项目唯一标识,测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值

约束限制:

不涉及

取值范围:

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值:

不涉及

task_uri

String

任务uri

表2 Query参数

参数

是否必选

参数类型

描述

version_uri

String

分支/迭代uri

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

status

String

success|error;

result

ResultValueTaskVo object

请求的返回的数据对象

error

ApiError object

失败时的error信息

request_id

String

由接口调用方传入,建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址

表5 ResultValueTaskVo

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值

value

TaskVo object

测试任务集合

reason

String

业务失败的提示内容

page_size

Integer

每页展示条数

page_no

Integer

页码

has_more

Boolean

是否有更多

表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

编码

表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

接口调用失败错误信息

请求示例

获取测试套任务详情

get https://{endpoint}/v4/300c6295a54c4c698608c878f47ddd59/tasks/v91j0000vldlep5u?version_uri=v91j0000vldleodb

响应示例

状态码: 200

OK

{
  "status" : "success",
  "result" : {
    "value" : {
      "uri" : "v91j0000vldlep5u",
      "name" : "样例功能套件",
      "number" : "002",
      "region" : "cn-north-7",
      "author_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3",
      "author_name" : "xxx",
      "owner_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3",
      "owner_name" : "xxx",
      "parent_path" : "/300c6295a54c4c698608c878f47ddd59/v91j0000vldleo9v/",
      "version_uri" : "v91j0000vldleo9v",
      "branch_uri" : "v91j0000vldleo9v",
      "creation_date" : "2024-06-24 10:26:19",
      "create_date_timestamp" : 1719195979000,
      "update_time" : "2024-06-24 10:26:19",
      "update_time_timestamp" : 1719195979000,
      "relation_change_time" : "2024-06-24 10:26:19",
      "relation_change_time_timestamp" : 1719195979000,
      "updator_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3",
      "relation_changer_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3",
      "service_type" : 0,
      "tag_list" : [ ],
      "execute_way" : 1,
      "execute_type" : 0,
      "status_code" : 0,
      "execute_status_code" : 0,
      "project_uuid" : "300c6295a54c4c698608c878f47ddd59",
      "case_operation_info" : {
        "test_cases_info" : [ {
          "status" : {
            "id" : "0",
            "name" : "新建"
          },
          "result" : {
            "id" : "-1"
          },
          "owner" : { },
          "case_uri" : "v91j0000vldlep4q",
          "is_available" : 1,
          "test_case_name" : "样例功能用例_修改",
          "test_case_number" : "008",
          "case_type" : 0
        } ],
        "set_up_cases_info" : [ ],
        "tear_down_cases_info" : [ ]
      },
      "assign_case_num" : 0,
      "finish_case_num" : 0,
      "assign_defect_num" : 0,
      "iterator_version_uri" : "v91j0000vldleodb"
    }
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档