# 查询附件列表 - ListAttachmentsV4
#### 功能介绍
此接口用于查询附件列表,同页面 测试 -\> 测试用例 -\> 点击用例，进入用例详情页 -\> 右侧基本信息附件
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v4/{project_id}/resources/{resource_uri}/attachments
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| project_id   | 是    | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制**: 字符串类型，长度32位字符 **取值范围**: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 **默认取值**: 不涉及 |
| resource_uri | 是    | String | **参数解释** 资源Uri **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                         |
   
表2Query参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| resource_type | 是    | String | **参数解释**: 资源类型 **约束限制**: 根据资源类型传入对应的值 **取值范围**: - TestResult，测试结果。   - Task，测试任务。   - TestCase，测试用例。   - TestReport，测试报告。    **默认取值**: 不涉及 |
   
#### 请求参数
表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                                                                    | **参数解释** 总数据量 **取值范围** 不涉及                       |
| value     | Array of [AttachmentVo] objects | **参数解释** 请求返回的数据 **取值范围** 实际的数据类型：单个对象，集合 或 NULL |
| reason    | String                                                                     | **参数解释** 业务失败的提示内容 **取值范围** 不涉及                  |
| page_size | Integer                                                                    | **参数解释** 分页大小 **取值范围** 不涉及                       |
| page_no   | Integer                                                                    | **参数解释** 分页编码 **取值范围** 不涉及                       |
| has_more  | Boolean                                                                    | **参数解释** 是否有更多 **取值范围** true:是 false:否           |
   
 表5AttachmentVo 
| 参数                    | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| uri                   | String  | **参数解释** 附件Uri **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                |
| creator               | String  | **参数解释** 创建人 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                  |
| updator               | String  | **参数解释** 更新人 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                  |
| region                | String  | **参数解释** 逻辑region **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                             |
| doc_id                | String  | **参数解释** 文档id **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                 |
| parent_uri            | String  | **参数解释** 父节点Uri **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                               |
| parent_type           | String  | **参数解释**: 父节点类型 **取值范围**: - exportFile，导出用例文件附件。   - exportErrorFile，导出错误用例文件附件。    |
| file_name             | String  | **参数解释** 文件名 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                  |
| store_file_name       | String  | **参数解释** 保存文件名 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                |
| file_path             | String  | **参数解释** 文件路径 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                 |
| file_size             | Integer | **参数解释** 文件大小 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                 |
| file_type             | String  | **参数解释**: 文件类型 **取值范围**: - txt，文本文件。   - img，图片文件。    等等                            |
| system_type           | String  | **参数解释**: 系统类型 **取值范围**: - docman，docman系统。   - testman，testman系统。                  |
| create_time           | String  | **参数解释** 创建时间 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                 |
| create_time_timestamp | Long    | **参数解释** 创建时间时间戳 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                              |
| update_time           | String  | **参数解释** 更新时间 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                 |
| update_time_timestamp | Long    | **参数解释** 更新时间时间戳 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                              |
| project_uuid          | String  | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 不涉及                                                                                                                                                                                                                                                   |
| related_type          | String  | **参数解释**: 附件类型 **取值范围**: - 0，本地上传。   - 1，关联文档。                                      |
| storage_system        | String  | 附件存储系统                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
**状态码：400**
表6响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                               |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表7响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                               |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表8响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                               |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表9响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                               |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
GET https://{endpoint}/v4/90f8dc52eb7b4c47b853c661152ca62d/resources/v901000109n3a3mt/attachments?resource_type=TestCase
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : [ {
    "uri" : "v90b000109n4c8kn",
    "creator" : "dfc5347b9b16491e942ce55ce7f79dbc",
    "region" : {
      "region" : null
    },
    "doc_id" : "",
    "parent_uri" : "v901000109n3a3mt",
    "parent_type" : "TestCase",
    "file_name" : "20220802-091407(WeLinkPC).png",
    "store_file_name" : "20220802-091407(WeLinkPC).png",
    "file_path" : "attachment_obs/90f8dc52eb7b4c47b853c661152ca62d/TestCase/v901000109n3a3mt/20220802-091407(WeLinkPC).png",
    "file_size" : 67962,
    "system_type" : "testman",
    "create_time" : "2025-03-03 15:54:12",
    "create_time_timestamp" : 1740988452000,
    "update_time" : "2025-03-03 15:54:12",
    "update_time_timestamp" : 1740988452000,
    "project_uuid" : "90f8dc52eb7b4c47b853c661152ca62d"
  } ]
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。