GetKnowledgeBasePreSignedUrl - 获取知识库文件预签名 URL

更新时间:
复制 MD 格式

为 `Documents` 中的每个文件生成一个指向知识库专属存储的 **OSS 预签名 PUT URL**,调用方用该 URL 直接把文件内容上传到对象存储,随后调用 `AddDocuments` 完成注册。单次最多 100 个文件。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

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

否

本地上传场景传文件名或相对路径;不能以 direct_upload/、uploaded/ 开头,不能包含空段/./..,≤1024 字节

contract-2026.md

Name

string

否

文件显示名,缺省取 Path 的文件名

CHANGELOG.md

Size

integer

否

文件大小(字节)

1024

ExpiresIn

integer

否

预签名 URL 有效期秒数,默认 3600

3600

返回参数

名称

类型

描述

示例值

object

Schema of Response

data

object

返回结果

preSignedUrls

array

预签名 PUT URL 列表,顺序与请求 Documents 一一对应

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
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。