ApplyFileUploadLease
请求一个上传租约用于上传非结构化文档,或智能体应用会话交互的文件。不支持通过API创建结构化数据表并上传数据,请通过控制台操作
服务地址:
华东2 金融云
输入参数
只看必填
CategoryId上传用于构建知识库的非结构化数据时:
FileName上传用于构建知识库的非结构化数据时:
Md5上传文档的MD5值
SizeInBytes上传文档的大小
WorkspaceId上传文档所属的业务空间 ID
CategoryType类目类型
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • RAM 用户(子账号)需要首先获取百炼的数据权限(需要AliyunBailianDataFullAccess,已包括 sfm:ApplyFileUploadLease 权限点),然后才能调用本接口,详见为 RAM 用户授予数据权限。阿里云账号(主账号)可直接调用无须授权。建议您通过最新版百炼 SDK来调用本接口。
  • 本接口返回的信息包括:一个用于上传非结构化文档到数据的 HTTP URL 链接(租约),以及上传所需的相关参数,示例请参考通过 API 上传文档
  • 本接口返回的 HTTP URL 链接有效期为分钟级,请及时上传文档,以免链接过期导致无法上传。
  • 申请文档上传租约并上传文档后,文档将暂存于百炼的临时存储空间内 12 小时,请及时调用 AddFile 接口将文档导入至百炼数据管理
  • 本接口不具备幂等性。

限流说明: 本接口频繁调用会被限流,频率请勿超过 10 次/秒。如遇限流,请稍后重试。

请求语法

POST /{WorkspaceId}/datacenter/category/{CategoryId} HTTP/1.1

路径参数

字段名称字段详情
CategoryIdstring

上传用于构建知识库的非结构化数据时:展开详情

示例值:cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx
WorkspaceIdstring

上传文档所属的业务空间 ID。获取方式请参见如何使用业务空间

示例值:llm-3z7uw7fwz0vexxxx

请求参数

字段名称字段详情
FileNamestring

上传用于构建知识库的非结构化数据时:展开详情

示例值:XXXX产品清单.pdf参考取值来源:
    ListFile
    DescribeFile
Md5string

上传文档的 MD5 值,服务端会验证该字段(当前暂未开启),请正确填写。

示例值:19657c391f6c70bcea63c154d8606bb3字符长度 <= 64字符长度 >= 1
SizeInBytesstring

上传文档的大小,单位字节,服务端会验证该字段(当前暂未开启),请正确填写。取值范围:1B-100M。

示例值:1000
CategoryTypestring

类目类型,不传入该参数时,默认值为 UNSTRUCTURED。展开详情

示例值:UNSTRUCTURED枚举值:UNSTRUCTUREDSESSION_FILE

返回参数

字段名称字段详情
Codestring

错误状态码。

示例值:DataCenter.FileTooLarge
Dataobject

接口业务数据字段。

Messagestring

错误信息。

示例值:User not authorized to operate on the specified resource
RequestIdstring

请求 ID。

示例值:778C0B3B-xxxx-5FC1-A947-36EDD13606AB
Statusstring

接口返回的状态码。

示例值:200
Successboolean

接口调用是否成功,可能值为:展开详情

示例值:true
变更历史
变更时间变更内容概要操作
2024-12-26
新增请求参数CategoryType
2024-08-20
变更请求参数Md5