文档首页/ 性能测试 CodeArts PerfTest/ API参考/ API/ 任务管理/ 获取任务关联的用例列表 - ListTaskCases
更新时间：2025-12-01 GMT+08:00
查看PDF
分享

获取任务关联的用例列表 - ListTaskCases

功能介绍

获取任务关联的用例列表

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    codeartsperftest:cpts:getPerfTestTask

    Read

    cpts *

    g:ResourceTag/<tag-key>

    -

    -

URI

GET /v1/{project_id}/test-suites/{test_suit_id}/tasks/{task_id}/test-cases

表1 路径参数

参数

是否必选

参数类型

描述

test_suit_id

是

Integer

工程ID

project_id

是

String

表示项目ID，参见获取方法说明。

task_id

是

Integer

任务ID，通过“创建任务”接口获取响应体中的task_id字段的值。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

code

String

响应码

message

String

响应消息

test_cases

Array of TestCaseBriefInfo objects

用例列表
表3 TestCaseBriefInfo

参数

参数类型

描述

id

Integer

用例ID，通过“创建用例”接口获取响应体中的json.test_case_id字段的值。

name

String

用例名称

status

Integer

状态（0-已删除；1-启用；2-停用；）

create_time

String

创建时间

update_time

String

更新时间

parent_id

Integer

所属目录ID

type

Integer

类型（1-目录；2-用例；）

请求示例

查询id是1的任务关联的用例信息。

/v1/{project_id}/test-suites/{test_suit_id}/tasks/1/test-cases

"code"

响应示例

无

状态码

状态码

描述

200

用例列表响应对象

错误码

请参见错误码。

父主题： 任务管理

相关文档