UploadSemanticFile - 申请语义任务附件上传地址-大数据开发治理平台 DataWorks(DataWorks)-阿里云帮助中心

接口说明

使用场景

申请参考文件的上传槽，用于为 CreateSemanticJob 的 singleTableFile 来源准备上传文件。

调用流程

传入文件名、MIME 类型和实际大小，调用本接口获取 Data.UploadUrl 和 Data.FileId。
在 UploadUrl 有效期内以相同的 Content-Type 执行 HTTP PUT 上传。
上传完成后，将 FileId 作为 CreateSemanticJob.ReferenceFileIds 的唯一元素。

安全注意事项

UploadUrl 是短期有效的预签名 PUT 地址，持有者可写入对应对象；不得记录、分享或长期保存该地址。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
FileName	string	是	待上传参考文件的原始文件名，最长 255 个字符。singleTableFile 使用 FileId 时仅支持 CSV 或 XLSX 文件。	reference.pdf
ContentType	string	是	上传对象的 MIME 类型，最长 128 个字符。该值会参与 UploadUrl 的签名，执行 PUT 时应使用相同的 Content-Type。	application/pdf
SizeBytes	integer	是	待上传文件大小，单位为字节。该值记录为附件元数据；请填写实际文件大小。	1024

请根据各请求字段的说明构造调用参数。

返回参数

名称	类型	描述	示例值
	object	申请附件上传槽的标准响应。Data.FileId 在完成 PUT 上传后可作为 CreateSemanticJob.ReferenceFileIds 的唯一文件引用。
RequestId	string	请求 ID。用于定位日志和排查问题。	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	请求是否成功
Data	object	附件上传槽信息。先在 Data.ExpiresAt 前将文件 PUT 到 Data.UploadUrl，再使用 Data.FileId 创建单文件语义任务。
FileId	string	附件唯一标识。完成对 UploadUrl 的 PUT 上传后，填入 CreateSemanticJob 的 ReferenceFileIds。	FID1
UploadUrl	string	临时 OSS PUT 上传地址，有效期 30 分钟，仅可上传指定对象。请使用请求中的 ContentType 执行 PUT，且不要记录、传播完整 URL。	https://example.com/temporary-upload-url
ExpiresAt	integer	UploadUrl 的过期时间，单位为毫秒的 Unix 时间戳；超过该时间需重新调用 UploadSemanticFile 申请地址。	1700001800000

响应字段含义和后续调用关系请参阅各字段说明。

示例

正常返回示例

JSON格式

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": true,
  "Data": {
    "FileId": "FID1",
    "UploadUrl": "https://example.com/temporary-upload-url",
    "ExpiresAt": 1700001800000
  }
}

错误码

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

变更历史

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