UploadSemanticFile - DataWorks

申請臨時 OSS PUT 上傳地址後，先在有效期內完成 PUT 上傳，再將返回的 FileId 填入 CreateSemanticJob 的 ReferenceFileIds。

介面說明

使用場景

申請參考檔案的上傳槽，用於為 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": false,
  "Data": {
    "FileId": "FID1",
    "UploadUrl": "https://example.com/temporary-upload-url",
    "ExpiresAt": 1700001800000
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。