# 获取指定文件、指定版本 ID 的版本信息 - getRevision
#### 功能介绍
获取指定文件、指定版本 ID 的版本信息
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/revision/getRevision
#### 请求参数
表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参数 
| 参数          | 是否必选 | 参数类型    | 描述                                            |
|:---|:---|:---|:---|
| containerId | 是    | String  | 空间ID                                          |
| fileId      | 是    | String  | 文件ID                                          |
| revisionId  | 是    | String  | 文件的assetId+versionId                          |
| urlType     | 否    | Integer | 下载地址类型缺省默认返回外网访问地址。详见枚举类型UrlType（1外网地址；2内网地址） |
| fields      | 否    | String  | 当前只支持\*，不传默认为\*                               |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                | 参数类型                                                         | 描述                                                              |
|:---|:---|:---|
| 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 | 文件内容审核信息注：仅普通文件返回                                               |
   
 表4FileAuditInfo 
| 参数          | 参数类型    | 描述                                                                                             |
|:---|:---|:---|
| auditLevel  | Integer | 审核级别详见枚举类型AuditLevel                                                                           |
| auditResult | Integer | 审核结果详见枚举类型AuditResult 对于文件元信息审核结果，仅支持 1、4；对于文件内容审核结果，仅支持 1、2、3。 |
| auditDetail | String  | 审核结果详情注：JSON 字符串格式，仅支持存取                                                                       |
   
#### 请求示例
获取指定文件、指定版本 ID 的版本信息
```
POST /koodrive/ose/v1/revision/getRevision
Authorization:Bearer+10f88d07fa************44791e9ff
{
    "containerId": "IAAFotBZGfP8nAncA1605108881422443136",
    "fileId": "Fk_LAN-LIgbxjFdH_YvJKoYW0vMjFyva8",
    "revisionId": "1605664519244256128.1605664519244256129"
}
```
#### 响应示例
**状态码：200**
获取指定文件、指定版本 ID 的版本信息响应
```
{
  "containerId" : "IAAFotBZGfP8nAncA1605108881422443136",
  "fileId" : "Fk_LAN-LIgbxjFdH_YvJKoYW0vMjFyva8",
  "revisionId" : "1605664519244256128.1605664519244256129",
  "revisionVersion" : 512,
  "keepForever" : false,
  "latestVersion" : true,
  "createdAt" : 1737682127312,
  "createdBy" : "ee33a28d0f454801b4532233258822e4",
  "updatedAt" : 1737682130017,
  "updatedBy" : "ZWUzM2EyOGQwZjQ1NDgwMWI0NTMyMjMzMjU4ODIyZTQtZWUzM2EyOGQwZjQ1NDgwMWI0NTMyMjMzMjU4ODIyZTQ",
  "name" : "ee33a28d0f454801b4532233258822e4",
  "size" : 1872637,
  "extension" : "AgAALVN-3Z5V2NASBMxH6L0DsLh7cKjg.jpeg",
  "fileType" : 15,
  "sha256" : "fb426b18ebc6ed393564f47371ab55e8f8e2b1336b195a877da1b7e7218a78fe",
  "downloadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/5debce8cf8074c7",
  "code" : 0,
  "msg" : "success"
}
```
#### 状态码
| 状态码 | 描述                     |
|:---|:---|
| 200 | 获取指定文件、指定版本 ID 的版本信息响应 |