
# 列举存证信息 - ListEvidences
#### 功能介绍
列举存证信息
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
GET /v1/{project_id}/evidences
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
表2Query参数 
| 参数          | 是否必选 | 参数类型    | 描述                                                   |
|:---|:---|:---|:---|
| limit       | 否    | Integer | 分页，每页大小,分页大小只支持10、20、50/页，默认显示10条/页                  |
| offset      | 否    | Integer | 偏移量，从第几项开始,默认值为0                                     |
| name        | 否    | String  | 按照存证名称字段搜索，不支持模糊匹配                                   |
| charge_type | 否    | String  | 存证类型, normal:普通存证                                    |
| begin_time  | 是    | String  | 按照时间范围搜索，起始时间 （UTC时间，毫秒级)，和end_time配合使用。最大时间不超过30天。  |
| end_time    | 是    | String  | 按照时间范围搜索，截止时间 （UTC时间，毫秒级)，和begin_time配合使用。最大时间不超过30天 |
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数          | 参数类型                                                           | 描述     |
|:---|:---|:---|
| total_count | Integer                                                        | 总记录    |
| evidences   | Array of [Evidence] objects | 存证信息列表 |
   
 表4Evidence 
| 参数          | 参数类型   | 描述                |
|:---|:---|:---|
| name        | String | 存证名称              |
| ev_id       | String | 存证ID              |
| file_hash   | String | 存证指纹              |
| charge_type | String | 存证类型, normal:普通存证 |
| create_time | String | 创建时间              |
| tx_id       | String | 交易ID              |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
无
#### 响应示例
无
#### 状态码
| 状态码 | 描述                   |
|:---|:---|
| 200 | evidence usage trend |
| 400 | Error response       |
   
