# 查询回收站 - SearchRecycleResource
#### 功能介绍
此接口用户查询回收站中的资源信息列表,对应要页面测试用例左下角回收站按钮,点击之后的列表页面
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/recycle
表1Query参数 
| 参数           | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| project_uuid | 是    | String  | **参数解释** 项目UUID **约束限制** 不涉及 **取值范围** 项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **默认取值** 不涉及 |
| page_no      | 是    | Integer | **参数解释** 页数 **约束限制** 不涉及 **取值范围** 大于0 **默认取值** 不涉及                                                                                                             |
| page_size    | 是    | Integer | **参数解释** 页面大小 **约束限制** 不涉及 **取值范围** 大于0 **默认取值** 不涉及                                                                                                           |
   
#### 请求参数
表2请求Body参数 
| 参数             | 是否必选 | 参数类型                                                                                  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| branch_uri     | 否    | String                                                                                | **参数解释** 分支uri **约束限制** 不涉及 **取值范围** 11-34位字母和数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| iterator_uri   | 否    | String                                                                                | **参数解释** 迭代uri **约束限制** 不涉及 **取值范围** 11-34位字母和数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| resource_type  | 否    | String                                                                                | **参数解释**: 查询资源类型 **约束限制**: 不涉及 **取值范围**: - TestCase，用例。   - TestItem，目录。   - IteratorTestCase，迭代用例。    **默认取值**: 不涉及 |
| delete_author  | 否    | String                                                                                | **参数解释** 删除人 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| name_or_number | 否    | String                                                                                | **参数解释** 搜索名称或编号 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| delete_date    | 否    | [RecycleDeleteDateInfo] object | **参数解释** 删除时间 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   
 表3RecycleDeleteDateInfo 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| start_date | 否    | String | **参数解释** 删除起始时间点 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                |
| end_date   | 否    | String | **参数解释** 删除结束时间点 **约束限制** 删除结束时间点需要大于删除起始时间点 **取值范围** 不涉及 **默认取值** 不涉及 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数        | 参数类型                                                                             | 描述                                                                                                                                                    |
|:---|:---|:---|
| total     | Integer                                                                          | **参数解释** 总数 **取值范围** 不涉及   |
| value     | Array of [RecycleBeanVo] objects | 请求返回的数据                                                                                                                                               |
| page_no   | Integer                                                                          | **参数解释** 分页编码 **取值范围** 大于0 |
| page_size | Integer                                                                          | **参数解释** 分页大小 **取值范围** 大于0 |
   
 表5RecycleBeanVo 
| 参数                    | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| uri                   | String  | **参数解释** 资源URI **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| type                  | String  | **参数解释**: 查询类型 **取值范围**: - TestCase，用例。   - Task，任务。   - TestVersion，分支。   - IteratorTestCase，迭代用例。    |
| name                  | String  | **参数解释** 名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| location              | String  | **参数解释** 初始位置 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| number                | String  | **参数解释** 用例编号 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| serviceType           | Integer | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。   - 1，接口自动化。   - 2，性能用例。                                                                                                                                                                                         |
| delete_date           | String  | **参数解释** 删除时间 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| delete_date_timestamp | Long    | **参数解释** 删除时间戳 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| delete_author         | String  | **参数解释** 删除人 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| delete_author_name    | String  | **参数解释** 删除人名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| version_uri           | String  | **参数解释** 分支/迭代uri **取值范围** 11-34位字母和数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| batch_uri             | String  | **参数解释** 删除批次标识uri **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| resource_type         | String  | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。   - TestItem，目录。   - IteratorTestCase，迭代用例。                                                                                                                                                                 |
   
**状态码：400**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表9响应Body参数 
| 参数         | 参数类型   | 描述                                 |
|:---|:---|:---|
| error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
post https://{endpoint}/v4/recycle?project_uuid=407ac57de7ea44d28e47293a2b9cf15c&page_no=1&page_size=10&_=1750063465600
{
  "branch_uri" : "123sb2355"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "total" : 1,
  "page_no" : 1,
  "page_size" : 5,
  "value" : [ {
    "uri" : "v90400010b5o5e4a",
    "type" : "Iteration TestCase",
    "name" : "cx_2992",
    "location" : "/基线/123/",
    "number" : "7414",
    "serviceType" : 0,
    "delete_date" : "2025-06-16 16:34:22",
    "delete_date_timestamp" : 1750062862000,
    "delete_author" : "2ce06fffb4634271a377c1cd7c429704",
    "delete_author_name" : "sec_admin——nich",
    "version_uri" : "v90100010b5nubs0",
    "batch_uri" : "v90100010i5id8mr",
    "resource_type" : "IteratorTestCase"
  } ]
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。