# 获取测试套任务详情 - ShowTaskDetail #### 功能介绍 此接口用于获取测试套任务详情，同页面 测试 -\> 测试执行 -\> 右侧点击测试套，进入详情页 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI GET /v4/{project_id}/tasks/{task_uri} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制**: 字符串类型，长度32位字符 **取值范围**: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 **默认取值**: 不涉及 | | task_uri | 是 | String | 任务uri | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | version_uri | 否 | String | 分支/迭代uri | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | [TaskVo] object | 测试任务集合 | | reason | String | 业务失败的提示内容 | | page_size | Integer | 每页展示条数 | | page_no | Integer | 页码 | | has_more | Boolean | 是否有更多 | 表5TaskVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释** 最近执行时间 **取值范围** 格式为yyyy-MM-dd HH:mm:ss | | execute_latest_time_timestamp | Long | **参数解释** 最近执行时间时间戳 **取值范围** 单位（毫秒） | | execute_duration | String | **参数解释** 执行时长 **取值范围** 单位（毫秒） | | execute_times | Integer | **参数解释** 执行次数 **取值范围** 不涉及 | | project_uuid | String | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 固定长度为32位字符 | | 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) | 表6CaseOperationVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | test_cases_info | Array of [TaskAssignCaseVo] objects | **参数解释** 用例关联信息 **取值范围** 不涉及 | | set_up_cases_info | Array of [TaskAssignCaseVo] objects | **参数解释** 前置用例关联信息 **取值范围** 不涉及 | | tear_down_cases_info | Array of [TaskAssignCaseVo] objects | **参数解释** 后置用例关联信息 **取值范围** 不涉及 | 表7TaskAssignCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | sort | Integer | **参数解释** 排序顺序 **取值范围** 不涉及 | | case_uri | String | **参数解释** 用例uri **取值范围** 不涉及 | | is_available | Integer | **参数解释** 是否可用 **取值范围** 不涉及 | | test_case_name | String | **参数解释** 用例名称 **取值范围** 不涉及 | | test_case_number | String | **参数解释** 用例编号 **取值范围** 不涉及 | | svn_script_path | String | **参数解释** 脚本路径 **取值范围** 不涉及 | | case_type | Integer | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。 - 1，接口自动化。 - 2，性能用例。 | | status | [NameAndIdVo] object | **参数解释** 状态 **取值范围** 不涉及 | | result | [NameAndIdVo] object | **参数解释** 结果 **取值范围** 不涉及 | | owner | [NameAndIdVo] object | **参数解释** 责任人 **取值范围** 不涉及 | | rank | Integer | **参数解释** 用例等级 **取值范围** - 0，Priority 0。 - 1，Priority 1。 - 2，Priority 2。 - 3，Priority 3。 - 4，Priority 4。 | | creation_date | String | **参数解释** 创建时间 **取值范围** 字符串类型，时间格式为"yyyy-MM-dd HH:mm:ss" | | service_type | Integer | **参数解释** 执行方式 **取值范围** 不涉及 | 表8NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释** ID **取值范围** 不涉及 | | name | String | **参数解释** 名称 **取值范围** 不涉及 | 表9NameAndValueAndCodeVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释** 名称 **取值范围** 不涉及 | | value | Integer | **参数解释** 值 **取值范围** 不涉及 | | code | 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 | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 获取测试套任务详情 ``` get https://{endpoint}/v4/300c6295a54c4c698608c878f47ddd59/tasks/v91j0000vldlep5u?version_uri=v91j0000vldleodb ``` #### 响应示例 **状态码：200** OK ``` { "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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。