
# 图片列表 - ListImages
#### 功能介绍
图片列表
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
POST /v1/{project_id}/trace/trace-sweepcode/product-image/list
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型                                       | 描述                 |
|:---|:---|:---|:---|
| elementName | 否    | String                                     | 图片名称               |
| isDisplay   | 否    | String                                     | 是否展示:0 展示，1 不展示    |
| imageType   | 否    | String                                     | 图片类型:1 品宣，2 banner |
| merchant    | 是    | String                                     | 商户ID（取值为项目ID）      |
| query       | 是    | [Query] object | 分页信息               |
   
 表4Query 
| 参数      | 是否必选 | 参数类型    | 描述    |
|:---|:---|:---|:---|
| current | 否    | Integer | 当前页   |
| size    | 否    | Integer | 每页的数量 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数      | 参数类型                                      | 描述     |
|:---|:---|:---|
| code    | String                                    | 返回码    |
| message | String                                    | 响应消息   |
| data    | [data] object | 图片列表数据 |
   
 表6data 
| 参数       | 参数类型                                                    | 描述    |
|:---|:---|:---|
| pageNum  | Integer                                                 | 页数    |
| pageSize | Integer                                                 | 每页的数量 |
| total    | Integer                                                 | 总数    |
| pages    | Integer                                                 | 总页数   |
| record   | Array of [record] objects | 图片详情  |
   
 表7record 
| 参数          | 参数类型   | 描述            |
|:---|:---|:---|
| id          | String | 图片ID          |
| elementName | String | 图片名称          |
| elementUrl  | String | 图片url         |
| imageType   | String | 图片类型          |
| isDisplay   | String | 是否展示          |
| merchant    | String | 商户ID（取值为项目ID） |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
```
{
  "elementName" : 6666,
  "isDisplay" : "1",
  "imageType" : "2",
  "merchant" : "1759540612045058049",
  "query" : {
    "current" : 1,
    "size" : 2
  }
}
```
#### 响应示例
**状态码：200**
Success
```
{
  "code" : 200,
  "message" : "操作成功!",
  "data" : {
    "pageNum" : 1,
    "pageSize" : 2,
    "total" : 1,
    "pages" : 1,
    "record" : [ {
      "id" : 1496736284843344000,
      "elementName" : 666666999,
      "elementUrl" : "https://xxx.xxx.xxx.xxx/petaltrace/6BF050A8AA19BB2F0BFA9F2F0529991C.jpg",
      "imageType" : "2",
      "isDisplay" : "1",
      "merchant" : "1759540612045058049"
    } ]
  }
}
```
**状态码：500**
Error response
```
{
  "code" : "500",
  "message" : "系统异常"
}
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | Success        |
| 500 | Error response |
   
