在執行結束後，按任務名稱和可選執行識別碼返回產物下載地址；不傳 JobRunId 時返回該任務最新一次執行的結果。
介面說明
使用場景
為已提交的語意任務執行取得結果檔案的臨時下載地址，例如語意模型 YAML 等產物。介面返回下載地址，不直接返回檔案內容。
呼叫流程
使用任務名稱
JobName定位任務。若要取得特定一次執行的產物，傳入
RunSemanticJob.Data.JobRunId或ListSemanticJobRuns中的JobRunId；不傳時返回最近一次執行的產物。從
Data.Results[].DownloadUrl下載對應檔案。
注意事項
下載地址為臨時憑證，應僅在使用者端短時使用，避免寫入日誌或長期儲存。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| JobName |
string |
是 |
任務名稱，使用 CreateSemanticJob 回應的 Data.Name、ListSemanticJobs 清單項目的 Name，或 ListSemanticJobRuns 記錄中的 JobName。 |
semantic-job-demo |
| JobRunId |
string |
否 |
可選的執行識別碼。填入 RunSemanticJob 回應的 Data.JobRunId 或 ListSemanticJobRuns 記錄中的 JobRunId 時，僅返回該次執行的產物；不填則返回該任務最新一次執行的產物。 |
01H00000000000000000000000 |
請根據各請求欄位的說明建構呼叫參數。
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
取得執行產物下載地址的標準回應。Data.Results 中每項對應一個結果檔案。 |
||
| RequestId |
string |
請求 ID。用於定位日誌和排查問題。 |
676271D6-53B4-57BE-89FA-72F7AE1418DF |
| Success |
boolean |
請求是否成功。 |
|
| Data |
object |
指定任務執行的結果檔案集合；同一次執行產生多個檔案時會返回多項。 |
|
| Results |
array<object> |
結果檔案清單。每項攜帶所屬任務、所屬執行和一個短時有效的下載地址。 |
|
|
object |
一個由語意任務執行產生的結果檔案。 |
||
| JobName |
string |
產物所屬任務名稱，與請求的 JobName 一致。 |
semantic-job-demo |
| JobRunId |
string |
產物所屬執行識別碼；可與 RunSemanticJob 的 Data.JobRunId 或 ListSemanticJobRuns 的 JobRunId 對照。 |
01H00000000000000000000000 |
| DownloadUrl |
string |
結果檔案的臨時預簽章下載位址。請盡快透過 HTTP GET 下載，且請勿記錄、傳播完整 URL 或將其視為長期位址。 |
https://example.com/temporary-download-url |
回應欄位含義和後續呼叫關係請參閱各欄位說明。
樣本
正常返回樣本
JSON格式
{
"RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
"Success": false,
"Data": {
"Results": [
{
"JobName": "semantic-job-demo",
"JobRunId": "01H00000000000000000000000",
"DownloadUrl": "https://example.com/temporary-download-url"
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。