申请上传租约 - Agent Studio

上传文件到数据中心的第一步，返回 OSS 预签名 URL 和租约 ID

POST

/api/v1/connector/dash/applyFileUploadLease

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/applyFileUploadLease" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "cate_abc123",
    "fileName": "product-guide.pdf",
    "sizeBytes": "1048576",
    "contentMd5": "d41d8cd98f00b204e9800998ecf8427e"
  }'

{
  "code": "Success",
  "message": "",
  "messageUnmodified": false,
  "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "type": "OSS.PreSignedUrl",
    "param": {
      "url": "https://oss-example.aliyuncs.com/...",
      "method": "PUT",
      "headers": {
        "x-bailian-extra": "MTkxMDA3MzE0NjA0NDgzNA==",
        "Content-Type": "text/plain"
      }
    },
    "leaseId": "82845f78ab0343ada293c9595ed93dbf.1782191906659"
  },
  "status": 200
}

文件上传分为三步：

申请租约（本接口）— 获取 OSS 预签名 URL 和 leaseId
PUT 上传到 OSS — 使用返回的 param.url 和 param.headers 通过 HTTP PUT 上传文件二进制内容
注册文件（addFile）— 使用 leaseId 将文件注册到数据中心

请注意 sizeBytes 必须以字符串格式传入（如 "1048576"），不能传数字。

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://agent.console.aliyun.com/settings/apikey）获取。

Body

application/json

string

required

类目 ID（注意：此字段名为 category，不是 categoryId），通过 listCategory 获取。

string

required

文件名称，包含扩展名。

string

required

文件大小（字节），以字符串格式传入。

Required range:x >= 1

string

required

文件内容的 MD5 值（Base64 编码）。

Required range:length: 1–64

enum<string>

default"UNSTRUCTURED"

类目类型，默认 UNSTRUCTURED。UNSTRUCTURED：类目，用于构建知识库；SESSION_FILE：用于智能体应用会话交互的文件。使用 SESSION_FILE 时，addFile 的 categoryType 也须传 SESSION_FILE；此类文件仅当前会话有效，关闭会话后过期（最长 7 天），不支持长期保存。

Available options:UNSTRUCTURED,SESSION_FILE

boolean

defaultfalse

是否使用安全存储空间的内网 Endpoint 上传，默认 false。

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

string

请求唯一标识，排查问题时请提供此 ID。

object

Show child attributes

string

上传类型，固定为 OSS.PreSignedUrl。

string

上传租约 ID，在注册文件时使用。

object

OSS 上传参数。

Show child attributes

string

OSS 预签名上传 URL。

string

HTTP 方法，固定为 PUT。

object

上传时需要携带的请求头。

Show child attributes

string

百炼平台附加信息。

string

内容类型。