# 列举指定文件的所有版本信息 - listRevision
#### 功能介绍
列举指定文件的所有版本信息。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/revision/listRevision
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                            |
|:---|:---|:---|:---|
| Authorization | 是    | String | 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} |
| X-User-Id     | 是    | String | 用户id，用于app鉴权                                                                                                                                                  |
| X-Date        | 是    | String | 日期，用于app鉴权                                                                                                                                                    |
| X-Traceid     | 否    | String | 消息日志跟踪标识（必须58位）                                                                                                                                               |
   
表2请求Body参数 
| 参数          | 是否必选 | 参数类型                                               | 描述              |
|:---|:---|:---|:---|
| pageInfo    | 否    | [PageInfo] object | 分页信息            |
| containerId | 是    | String                                             | 空间ID            |
| fileId      | 是    | String                                             | 文件ID            |
| fields      | 否    | String                                             | 当前只支持\*，不传默认为\* |
   
 表3PageInfo 
| 参数         | 是否必选 | 参数类型    | 描述           |
|:---|:---|:---|:---|
| pageSize   | 否    | Integer | 每页文件数量，默认100 |
| pageCursor | 否    | String  | 分页起始游标       |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数             | 参数类型                                                                          | 描述                                                            |
|:---|:---|:---|
| revisionList   | Array of [FileRevisionInfo] objects | 文件版本信息列表默认按版本创建时间降序排序注：列举版本信息时FileRevisionInfo 不返回downloadUrl |
| nextPageCursor | String                                                                        | 下一页起始游标，最后一页值为空                                               |
   
 表5FileRevisionInfo 
| 参数                | 参数类型                                                          | 描述                                                              |
|:---|:---|:---|
| containerId       | String                                                        | 空间ID                                                            |
| fileId            | String                                                        | 文件ID                                                            |
| revisionId        | String                                                        | 版本ID（就是云空间返回的assetId+"."+versionId）                             |
| revisionVersion   | Long                                                          | 版本号，唯一递增                                                        |
| keepForever       | Boolean                                                       | 是否永久保留                                                          |
| latestVersion     | Boolean                                                       | 是否为最新版本，对比版本id和files.get.metadata的版本id是否一致                      |
| createReason      | Integer                                                       | 版本创建缘由详见枚举类型RevisionCreateReason，1 创建文件；2 历史版本恢复                |
| createdAt         | Long                                                          | 创建时间，毫秒时间戳，云空间版本查询接口的createdTime                                |
| createdBy         | String                                                        | 查询接口返回的attributes的createdBy                                     |
| updatedAt         | Long                                                          | 更新时间，毫秒时间戳，云空间版本查询接口的editedTime                                 |
| updatedBy         | String                                                        | 修改者ID，查询响应的lastEditor的userId可以解析出三方id                           |
| name              | String                                                        | 文件名称（包含扩展名）禁止出现以下9 个非法字符：''、'/'、':'、'\*'、'?'、'"'、'\<'、'\>'、'\|' |
| size              | Long                                                          | 文件大小单位：字节                                                       |
| extension         | String                                                        | 文件扩展名注：不区分大小写                                                   |
| fileType          | Integer                                                       | 查看接口的attributes的fileType                                        |
| description       | String                                                        | 描述，files.get.metadat获取description                               |
| sha256            | String                                                        | 文件内容Hash 值，十六进制字符串注：不区分大小写                                      |
| downloadUrl       | String                                                        | 指定版本的文件下载地址                                                     |
| metadataAuditInfo | [FileAuditInfo] object | 文件元信息审核信息                                                       |
| contentAuditInfo  | [FileAuditInfo] object | 文件内容审核信息注：仅普通文件返回                                               |
   
 表6FileAuditInfo 
| 参数          | 参数类型    | 描述                                                                                              |
|:---|:---|:---|
| auditLevel  | Integer | 审核级别详见枚举类型AuditLevel                                                                            |
| auditResult | Integer | 审核结果详见枚举类型AuditResult 对于文件元信息审核结果，仅支持 1、4；对于文件内容审核结果，仅支持 1、2、3。 |
| auditDetail | String  | 审核结果详情注：JSON 字符串格式，仅支持存取                                                                        |
   
#### 请求示例
列举指定文件的所有版本信息
```
POST /koodrive/ose/v1/revision/listRevision
Authorization:Bearer+10f88d07fa************44791e9ff
{
  "containerId": "IAAAKIRZGifzJgncA1605122035640590977",
  "fileId": "FkiferVNK5NwXck7XXBhPLIRhV1GayJPc",
    "pageInfo": {
        "pageSize": 100,
        "pageCursor": null
    }
}
```
#### 响应示例
**状态码：200**
列举指定文件的所有版本信息
```
"revisionList"
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | 列举指定文件的所有版本信息 |