找不到 API ? 点击 反馈吧
- 数据中心
- 知识索引
- Prompt工程
- 长期记忆
ApplyFileUploadLease
请求一个上传租约用于上传非结构化文档,或智能体应用会话交互的文件。不支持通过API创建结构化数据表并上传数据,请通过控制台操作
服务地址:
华东2 金融云
参数配置
高级配置
输入参数
只看必填
注意事项
CategoryId上传用于构建知识库的非结构化数据时:
FileName上传用于构建知识库的非结构化数据时:
Md5上传文档的MD5值
SizeInBytes上传文档的大小
WorkspaceId上传文档所属的业务空间 ID
CategoryType类目类型
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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
路径参数
请求参数
字段名称 | 字段详情 |
---|---|
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 |