
# 更新文档元数据信息 - UpdateFileMeta
#### 功能介绍
更新文档元数据信息。
#### URI
PUT /v1/{project_id}/applications/{application_id}/uni-search/{repo_id}/files/{file_id}
表1路径参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| project_id     | 是    | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0022.html)。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及                                                             |
| application_id | 是    | String | **参数解释：** 应用ID，获取方法请参见[获取应用ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0021.html)。 **约束限制：** 字符串 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及                                                             |
| repo_id        | 是    | String | **参数解释：** 知识库ID。 获取方式： 账号登录KooSearch体验平台，在左侧导航栏选择："知识库管理" ，在此界面获取"知识库ID"字段的值，表示该知识库在向量数据库中存储的ID，具有唯一性。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线。 **默认取值：** 不涉及 |
| file_id        | 是    | String | **参数解释：** 文件ID。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线。 **默认取值：** 不涉及                                                                                                                                                            |
   
表2Query参数 
| 参数          | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| category    | 否    | String           | **参数解释：** 文档目录，单值，对应目录树中的叶子节点。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                         |
| tags        | 否    | Array of strings | **参数解释：** 标签列表。其中每个tag只能包含1到255位英文字母、中文、数字、中划线或者下划线，并且以字母、数字或者中文开头。 **约束限制：** 25.2.T1版本增加URL常用特殊字符：:/.?\&=@#%+\~!$'(),;\*\[\] 等特殊字符。 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| expire_time | 否    | String           | **参数解释：** 过期时间戳。 **约束限制：** 不涉及 **取值范围：** 长度13位时间戳。 **默认取值：** 不涉及                                                                                                 |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 接口鉴权使用的Token，Token获取方式参考：[获取IAM用户Token](https://support.huaweicloud.com/api-koosearch/koosearch_06_0009.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数      | 参数类型   | 描述                                                                                                                                     |
|:---|:---|:---|
| file_id | String | **参数解释：** 上传文件的id。 **取值范围：** 不涉及 |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                 |
|:---|:---|:---|
| error_code | String | **参数解释：** [错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。 **取值范围：** 不涉及 |
| error_msg  | String | **参数解释：** 错误描述。 **取值范围：** 不涉及                                                                |
   
**状态码：500**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                 |
|:---|:---|:---|
| error_code | String | **参数解释：** [错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。 **取值范围：** 不涉及 |
| error_msg  | String | **参数解释：** 错误描述。 **取值范围：** 不涉及                                                                |
   
#### 请求示例
表单格式
```
/v1/b25446daeb1a41a7953c5deba2b2677a/applications/cefb2a59-2f9e-4268-b56b-eab15dc0b9d6/uni-search/0e7a261c-a543-4f98-915d-7a83ac96595c/files/7bb4d9351fa8a00cd30782bfd29a1766
```
#### 响应示例
**状态码：200**
更新后文档元数据。
```
{
  "file_id" : "7bb4d9351fa8a00cd30782bfd29a1766"
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | 更新后文档元数据。 |
| 400 | 参数错误。     |
| 500 | 内部异常。     |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。
