文件关联、引用与临时读取¶
工作区普通上传创建file记录和存储对象,不自动关联卷;私有Catalog上传自动建立私有卷关联并将引用计数增加为1。列表读取卷关联位置,未关联文件不会因普通上传自动出现在位置列表。
上传先持久化元数据再写对象,私有卷发布还有后续事务。失败不保证前面步骤回滚,也没有本协议幂等请求键;不要把客户端超时当作完全没有创建。保留已返回标识并检查实际状态,清理由实际权限与引用计数决定。
DELETE工作区文件要求零引用,内置样例受保护;解除卷引用使用其已有接口。引用计数为正或并发清理失败可拒绝,成功以HTTP204及后续读取为准。外部文件清理只处理MOI元数据,不删除源连接器对象。
模型链接签发需配置BaseURL、密钥与TTL。url使用签名能力验证,不依赖外部调用者的产品身份;到期时间以expires_at为准。内容端将不可读、无效、过期、空文件统一为404。链接读取不表示已做模型推理。
预览与下载选择不同内容类型。HTML/HTM/SVG预览为附件,Office转换依赖配置;原始下载可只取前缀,其成功长度不能当原文件长度。
最后更新于