# 查询知识库版本列表 - ListKnowledgeVersions
#### 功能介绍
查询知识库版本列表。
#### URI
GET /v1/{project_id}/applications/{application_id}/uni-search/knowledge-repo/{repo_id}/versions
表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个字符，只能包含数字、字母、中划线和下划线。 **默认取值：** 不涉及 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数       | 参数类型                                                                                   | 描述                                                                                                                                                       |
|:---|:---|:---|
| total    | Integer                                                                                | **参数解释：** 版本总数。 **取值范围：** 不涉及 |
| versions | Array of [KnowledgeVersion] objects | **参数解释：** 版本列表。 **取值范围：** 不涉及 |
   
 表3KnowledgeVersion 
| 参数              | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| id              | String  | **参数解释：** 版本id。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| repo_id         | String  | **参数解释：** 知识库ID。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| name            | String  | **参数解释：** 版本名称。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| detail          | String  | **参数解释：** 版本描述。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| status          | String  | **参数解释：** 版本状态。 **取值范围：** - active：使用中   - open：可用   - closed：关闭。    |
| create_options  | String  | **参数解释：** 创建选项。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| progress        | Integer | **参数解释：** 以索引方式重建时，reindex进度。当重建完成后，此字段会清空。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| create_user     | String  | **参数解释：** 知识库创建用户名。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| create_time     | String  | **参数解释：** 创建时间。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| update_time     | String  | **参数解释：** 更新时间。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| project_id      | String  | **参数解释：** 项目标识。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| embedding_model | String  | **参数解释：** embedding模型名称为版本重建时embedding模型集合中所选，未重建时为知识库中的embedding模型名称。 **约束限制：** 此参数只有25.7.T1及之后版本支持。 **取值范围：** embedding模型名称长度不超过32位。 **默认取值：** 跟知识库的embedding模型名称一致。                                                                                                                                                                                                           |
   
#### 请求示例
查询知识库版本列表。
```
/v1/1ed40ceefc8d40f8b884edb6a84e7768/applications/fb9731ab-7085-474f-b6c7-64473586f0f3/uni-search/knowledge-repo/05335b17-21f2-45f8-afeb-40bc1c583eb4/versions
```
#### 响应示例
**状态码：200**
响应体。
```
{
  "total" : 1,
  "versions" : [ {
    "id" : "df611892-3ebe-4168-9049-20a1c5f25fc0",
    "name" : "chy",
    "status" : "active",
    "create_user" : "cssmonitoruser",
    "create_time" : "1751685280110",
    "update_time" : "1751685280110",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "embedding_model" : "cjh-embedding-8k"
  } ]
}
```
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 200 | 响应体。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。