# 查询知识库下的所有标签 - ListLabel #### 功能介绍 查询知识库下的所有标签。 #### URI GET /v1/{project_id}/applications/{application_id}/uni-search/{repo_id}/labels 表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个字符，只能包含数字、字母、中划线和下划线。 **默认取值：** 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | page_num | 否 | Integer | **参数解释：** 当前请求的页码，表示从第几页开始获取数据。默认值为1，表示第一页。 **约束限制：** 不涉及 **取值范围：** 1～65535 **默认取值：** 1 | | page_size | 否 | Integer | **参数解释：** 每页显示的记录数，表示一次请求返回的数据条数。默认值为10，表示一页展示10条数据。 **约束限制：** 不涉及 **取值范围：** 1-65535 **默认取值：** 10 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 接口鉴权使用的Token，Token获取方式参考：[获取IAM用户Token](https://support.huaweicloud.com/api-koosearch/koosearch_06_0009.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | label_list | Array of [LabelInfo] objects | **参数解释：** 标签列表。 **取值范围：** 不涉及 | | total | Integer | **参数解释：** 知识库下的标签总数。 **取值范围：** 不涉及 | 表5LabelInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 标签id。 **取值范围：** 不涉及 | | name | String | **参数解释：** 标签名称。 只能包含1到255位英文字母、中文、数字以及URL特殊字符（ : - _ / . ? \& = @ # % + \~ ! $ ' ( ) , ; *\[\] ）；并且以字母、数字或者中文开头。 25.2.T1版本在原有基础上增加URL常用特殊字符：:/.?\&=@#%+\~!$'(),;*\[\] 等特殊字符。 **取值范围：** 不涉及 | | color | String | **参数解释：** 标签颜色。 **取值范围：** - red：红色 - yellow：黄色 - green：绿色 - blue：蓝色 - purple：紫色 - grey：灰色 | | create_time | String | **参数解释：** 创建时间，时间轴。 **取值范围：** 不涉及 | **状态码：500** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | #### 请求示例 ``` /v1/b25446daeb1a41a7953c5deba2b2677a/applications/5071b12e-8c5c-4181-a15b-41e6ae3915ea/uni-search/ae63178c-f9d1-46c9-96d2-de045dfc6810/labels?page_size=65535&page_num=1 ``` #### 响应示例 **状态码：200** 查询知识库下的所有标签响应成功。 ``` { "label_list" : [ { "id" : "3296", "name" : "test1", "color" : "RED", "create_time" : "1732797189009" }, { "id" : "6", "name" : "白色", "color" : "BLUE", "create_time" : "1732871764233" }, { "id" : "6ad48f65-99dc-406b-9ea6-16e5b30d0240", "name" : "星期五", "color" : "RED", "create_time" : "1732872062619" }, { "id" : "9", "name" : "托尔斯泰", "color" : "RED", "create_time" : "1732797203779" }, { "id" : "9d404d4a-3e6e-4e6e-a32b-a40fc4b944df", "name" : "目录1", "color" : "RED", "create_time" : "1732965317477" }, { "id" : "cc801dc3-2842-4d55-ae0b-1ceeae46f016", "name" : "黑色", "color" : "BLUE", "create_time" : "1732872043823" }, { "id" : "ff0f33d6-98fa-4008-a90b-1050a0e0af38", "name" : "梦入星河", "color" : "PURPLE", "create_time" : "1733226466014" } ], "total" : 7 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询知识库下的所有标签响应成功。 | | 500 | 内部异常。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。