DownloadSemanticResults - 获取语义任务结果下载地址-大数据开发治理平台 DataWorks(DataWorks)-阿里云帮助中心

接口说明

使用场景

为已提交的语义任务运行获取结果文件的临时下载地址，例如语义模型 YAML 等产物。接口返回下载地址，不直接返回文件内容。

调用流程

使用任务名称 JobName 定位任务。
若要获取特定一次运行的产物，传入 RunSemanticJob.Data.JobRunId 或 ListSemanticJobRuns 中的 JobRunId；不传时返回最近一次运行的产物。
从 Data.Results[].DownloadUrl 下载对应文件。

注意事项

下载地址为临时凭证，应仅在客户端短时使用，避免写入日志或长期保存。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
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": true,
  "Data": {
    "Results": [
      {
        "JobName": "semantic-job-demo",
        "JobRunId": "01H00000000000000000000000",
        "DownloadUrl": "https://example.com/temporary-download-url"
      }
    ]
  }
}

错误码

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

变更历史

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