# 获取任务关联的用例列表 - ListTaskCases
#### 功能介绍
获取任务关联的用例列表
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CPTS/doc?api=ListTaskCases)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cpts/cpts_api_0019.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                                   | 访问级别 | 资源类型（\*为必须） | 条件键                       | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | 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，参见[获取方法说明](https://support.huaweicloud.com/api-cpts/cpts_api_0017.html)。 |
| task_id      | 是    | Integer | 任务ID，通过"创建任务"接口获取响应体中的task_id字段的值。                                              |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数         | 参数类型                                                                             | 描述   |
|:---|:---|:---|
| code       | String                                                                           | 响应码  |
| message    | String                                                                           | 响应消息 |
| test_cases | Array of [TestCaseBriefInfo] objects | 用例列表 |
   
 表3TestCaseBriefInfo 
| 参数          | 参数类型    | 描述                                           |
|:---|:---|:---|
| 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 | 类型（2-用例）                                     |
   
#### 请求示例
查询id是1的任务关联的用例信息。
```
/v1/{project_id}/test-suites/{test_suit_id}/tasks/1/test-cases
"code"
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 用例列表响应对象 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cpts/ErrorCode.html)。