更新知识库的可编辑信息。
接口说明
更新知识库。租户和调用者身份由 POP 认证上下文确定。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| KnowledgeBaseId |
string |
是 |
目标知识库 ID |
12345678-1234-4234-8234-123456789abc |
| Name |
string |
否 |
新名称 |
销售知识 |
| Description |
string |
否 |
新描述 |
销售指标与制度文档 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
本次请求的唯一标识，可用于定位问题。 |
00000000-0000-4000-8000-000000000001 |
| Success |
boolean |
请求是否成功 |
|
| Data |
object |
成功时返回的业务数据。 |
|
| KnowledgeBaseId |
string |
服务生成的稳定知识库 ID |
12345678-1234-4234-8234-123456789abc |
| Name |
string |
用户可见名称 |
销售知识 |
| Description |
string |
用户维护的描述，可选 |
销售指标与制度文档 |
| Type |
string |
知识库的个人或企业类型，取值与现有权限规则对齐 |
PROJECT_SPACE_BUILD |
| Owner |
string |
负责人用户 ID，由服务端确定 |
1000000000000000 |
| AccessRole |
string |
当前调用者的只读访问角色，OWNER、ADMIN 或 VIEWER；不是写入参数 |
OWNER |
| Status |
string |
公共状态：ACTIVE（正常）、DELETED（已删除）；Get/List 仅返回正常可见知识库，删除成功返回 DELETED |
ACTIVE |
| CreateTime |
integer |
创建时间 |
1790200400000 |
| ModifyTime |
integer |
最近配置修改时间 |
1790200300000 |
| Code |
string |
业务错误码；请求失败时用于判断错误类型。 |
InvalidParameter |
| Message |
string |
请求失败时的安全错误信息。 |
请求参数不合法。 |
示例
正常返回示例
JSON格式
{
"RequestId": "00000000-0000-4000-8000-000000000001",
"Success": true,
"Data": {
"KnowledgeBaseId": "12345678-1234-4234-8234-123456789abc",
"Name": "销售知识",
"Description": "销售指标与制度文档",
"Type": "PROJECT_SPACE_BUILD",
"Owner": "1000000000000000",
"AccessRole": "OWNER",
"Status": "ACTIVE",
"CreateTime": 1790200400000,
"ModifyTime": 1790200300000
},
"Code": "InvalidParameter",
"Message": "请求参数不合法。"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter | The request parameters are invalid. | |
| 403 | Forbidden | You are not authorized to perform this operation. | |
| 404 | ResourceNotFound | The requested resource does not exist or is not visible. | |
| 503 | ServiceUnavailable | The service is temporarily unavailable. | |
| 409 | Conflict | The resource state conflicts with this operation. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。