文档首页/测试计划 CodeArts TestPlan/API参考/API/外部服务管理/获取测试套任务详情 - ShowTesthubTaskDetail
更新时间：2025-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取测试套任务详情 - ShowTesthubTaskDetail

功能介绍

获取测试套任务详情

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

task_uri

是

String

任务uri

表2 Query参数

参数

是否必选

参数类型

描述

version_uri

否

String

分支/迭代uri

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释:

调用此接口的响应状态。

取值范围:

  • success，表示接口调用成功。

  • failed，表示接口调用失败。

error

ApiError object

错误信息

request_id

String

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

server_address

String

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

result

TaskVo object

请求结果

表4 ApiError

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

表5 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

约束限制:

不涉及

取值范围:

  • -1，全量用例。

  • 0，手工测试。

  • 1，接口自动化。

  • 7，功能自动化。

  • 8，WebUI自动化。

  • 100，自定义自动化(工厂)。

  • 11，性能自动化。

默认取值:

不涉及

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)

表6 CaseOperationVo

参数

参数类型

描述

test_cases_info

Array of TaskAssignCaseVo objects

参数解释

用例关联信息

取值范围

不涉及

set_up_cases_info

Array of TaskAssignCaseVo objects

参数解释

前置用例关联信息

取值范围

不涉及

tear_down_cases_info

Array of TaskAssignCaseVo objects

参数解释

后置用例关联信息

取值范围

不涉及

表7 TaskAssignCaseVo

参数

参数类型

描述

sort

Integer

参数解释

排序顺序

取值范围

不涉及

case_uri

String

参数解释

用例uri

取值范围

不涉及

is_available

Integer

参数解释

是否可用

取值范围

不涉及

test_case_name

String

参数解释

用例名称

取值范围

不涉及

test_case_number

String

参数解释

用例编号

取值范围

不涉及

表8 NameAndValueAndCodeVo

参数

参数类型

描述

name

String

参数解释

名称

取值范围

不涉及

value

Integer

参数解释

值

取值范围

不涉及

code

String

参数解释

编码

取值范围

不涉及

状态码：400

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

get https://{endpoint}/v4/a5eb0d410ea341a192f7c12483568985/tasks/v90100010gpop47c?version_uri=v90100010gpop318

响应示例

状态码：200

OK

{
  "result" : {
    "author_name" : "wangluodan1",
    "relation_change_time_timestamp" : 1760751369000,
    "status_code" : 0,
    "execute_latest_time_timestamp" : 1760756120000,
    "execute_type" : 0,
    "owner_id" : "",
    "description" : "",
    "number" : "106",
    "execute_times" : 1,
    "version_uri" : "v90200010s1h6476",
    "update_time" : "2025-10-18 10:55:20",
    "tag_list" : [ ],
    "execute_status_code" : 0,
    "parent_path" : "/1b7179edc79a431f9711434124ac9f28/v90200010s1h6476/",
    "assign_defect_num" : 0,
    "create_date_timestamp" : 1760751369000,
    "execute_latest_time" : "2025-10-18 10:55:20",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "release_dev" : "",
    "branch_uri" : "v90200010s1h6476",
    "relation_changer_id" : "a17801c5d15f46e28112eec8a880683d",
    "relation_change_time" : "2025-10-18 09:36:09",
    "creation_date" : "2025-10-18 09:36:09",
    "finish_case_num" : 0,
    "uri" : "v90100010s43ok39",
    "updator_id" : "a17801c5d15f46e28112eec8a880683d",
    "service_type" : 0,
    "case_operation_info" : {
      "test_cases_info" : [ {
        "result" : {
          "name" : "成功",
          "id" : "0"
        },
        "owner" : { },
        "test_case_name" : "互联网出行安全_重启实例场景_生产和消费消息测试",
        "svn_script_path" : "",
        "service_type" : 0,
        "test_case_number" : "TC_Solution_T3_RabbiMQ_Func_003",
        "case_uri" : "v90200010s2af94i",
        "case_type" : 0,
        "rank" : 0,
        "creation_date" : "2025-10-17 16:54:54",
        "status" : {
          "name" : "完成",
          "id" : "7"
        },
        "is_available" : 1
      }, {
        "result" : {
          "id" : "-1"
        },
        "owner" : { },
        "test_case_name" : "互联网出行安全_私网和公网场景_连接已开启SSL连实例",
        "svn_script_path" : "",
        "service_type" : 0,
        "test_case_number" : "TC_Solution_T3_RabbiMQ_Func_002",
        "case_uri" : "v90200010s2af95l",
        "case_type" : 0,
        "rank" : 0,
        "creation_date" : "2025-10-17 16:54:54",
        "status" : {
          "name" : "新建",
          "id" : "0"
        },
        "is_available" : 1
      } ],
      "set_up_cases_info" : [ ],
      "tear_down_cases_info" : [ ]
    },
    "name" : "Task001",
    "assign_case_num" : 0,
    "result_code" : 0,
    "update_time_timestamp" : 1760756120000,
    "region" : "roma-guian-2",
    "author_id" : "a17801c5d15f46e28112eec8a880683d",
    "executor_id" : "a17801c5d15f46e28112eec8a880683d"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题：外部服务管理

相关文档