更新时间:2025-07-24 GMT+08:00
分享

获取测试套任务详情

功能介绍

获取测试套任务详情

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目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的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

status

String

success|error;

result

ResultValueTaskVo object

请求返回的数据

error

ApiError object

错误信息

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

参数解释

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目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" : [ {
          "case_uri" : "v91j0000vldlep4q",
          "sort" : 1,
          "is_available" : 1,
          "test_case_name" : "样例功能用例_修改",
          "test_case_number" : "008"
        } ],
        "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

错误码

请参见错误码

相关文档