GetKnowledgeBasePreSignedUrl - 获取知识库文件预签名 URL
为 `Documents` 中的每个文件生成一个指向知识库专属存储的 **OSS 预签名 PUT URL**,调用方用该 URL 直接把文件内容上传到对象存储,随后调用 `AddDocuments` 完成注册。单次最多 100 个文件。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/datasets/{datasetId}/getKnowledgeBasePreSignedUrl HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| datasetId |
string |
否 |
知识库 ID |
kb-3bd02617e9be335f |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求体 |
|
| KnowledgeBaseId |
string |
否 |
知识库 ID, 与 datasetId 二选一,此参数优先 |
kb-3bd02617e9be335f |
| Documents |
array<object> |
否 |
待上传文件列表,1~100 个 |
|
|
object |
否 |
导入文档 |
||
| Path |
string |
否 |
本地上传场景传文件名或相对路径;不能以 |
contract-2026.md |
| Name |
string |
否 |
文件显示名,缺省取 Path 的文件名 |
CHANGELOG.md |
| Size |
integer |
否 |
文件大小(字节) |
1024 |
| ExpiresIn |
integer |
否 |
预签名 URL 有效期秒数,默认 |
3600 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| data |
object |
返回结果 |
|
| preSignedUrls |
array |
预签名 PUT URL 列表,顺序与请求 |
|
|
string |
预签名 URL |
https://example.oss-cn-hangzhou.aliyuncs.com/object?signature=xxx |
|
| bucketName |
string |
存储桶名称 |
knowledgebase-fileupload |
| expiresIn |
integer |
预签名 URL 有效期秒数 |
3600 |
| code |
integer |
业务状态码 |
0 |
| accessDeniedDetail |
string |
权限校验失败详情 |
{"PolicyType":"AccountLevelIdentityBasedPolicy","AuthPrincipalOwnerId":"1234567890123456","AuthPrincipalType":"SubUser","AuthPrincipalDisplayName":"1234567890123456","NoPermissionType":"ImplicitDeny","AuthAction":"milvusknowledgebase:ListDatasets"} |
| success |
boolean |
请求是否成功 |
true |
| httpStatusCode |
integer |
HTTP 状态码 |
403 |
{
"code": 0,
"message": "success",
"requestId": "DDDBE0E5-4314-156F-B7F1-C4BCFD25A509",
"success": true,
"data": {
"bucketName": "kd-8b682030a90e5-1722921615717059",
"expiresIn": 3600,
"preSignedUrls": [
"https://kd-8b682030a90e5-1722921615717059.oss-cn-hangzhou.aliyuncs.com/direct_upload/1722921615717059/kd-8b682030a90e5/contract-2026.md?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx",
"https://kd-8b682030a90e5-1722921615717059.oss-cn-hangzhou.aliyuncs.com/direct_upload/1722921615717059/kd-8b682030a90e5/guide.md?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx"
]
}
}
示例
正常返回示例
JSON格式
{
"data": {
"preSignedUrls": [
"https://example.oss-cn-hangzhou.aliyuncs.com/object?signature=xxx"
],
"bucketName": "knowledgebase-fileupload",
"expiresIn": 3600
},
"code": 0,
"accessDeniedDetail": "{\"PolicyType\":\"AccountLevelIdentityBasedPolicy\",\"AuthPrincipalOwnerId\":\"1234567890123456\",\"AuthPrincipalType\":\"SubUser\",\"AuthPrincipalDisplayName\":\"1234567890123456\",\"NoPermissionType\":\"ImplicitDeny\",\"AuthAction\":\"milvusknowledgebase:ListDatasets\"}",
"success": true,
"httpStatusCode": 403
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。