文档首页/数据治理中心 DataArts Studio/API参考/数据开发API（V1）/脚本开发API/查询脚本实例执行结果 - ListScriptResults
更新时间：2025-11-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询脚本实例执行结果 - ListScriptResults

功能介绍

该接口用于获取脚本实例的执行状态和结果。

查询时，需要指定脚本名称和脚本实例ID。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

  • URI格式

    GET /v1/{project_id}/scripts/{script_name}/instances/{instance_id}

  • 参数说明
    表1 URI参数说明

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

    项目编号，获取方法请参见项目ID和账号ID。

    script_name

    是

    String

    脚本名称。

    instance_id

    是

    String

    脚本实例id，获取方法请参见执行脚本 - ExecuteScript的响应参数。

请求参数

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

否

String

工作空间id。

  • 如果不设置该参数，默认查询default工作空间下的数据。
  • 如果需要查询其他工作空间的数据，需要带上该消息头。
    说明：
    • 多个DataArts Studio实例需要指定工作空间。
    • 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。

响应参数

表3 参数说明

参数名

是否必选

参数类型

说明

status

是

String

执行状态。

LAUNCHING：提交中

RUNNING：运行中

FINISHED：执行成功

FAILED：执行失败

results

是

List<Result>

执行结果

message

否

String

执行失败消息。

表4 Result数据结构说明

参数名

是否必选

参数类型

说明

message

否

Object

结构返回信息。

schema

否

List<Map<String, String>>

元数据信息。

rows

否

List<List<Object>>

返回结果数据。

rowCount

否

Long

结果行数。

inputRowCount

否

Long

输入结果的行数。(dli等脚本执行会执行此结果)

resultCount

否

Long

结果行数。(dli等脚本执行会执行此结果)

duration

否

Float

脚本实例的执行时长，单位是秒。

rawResult

否

Map<String, Object>

脚本结果信息。

请求示例

GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/scripts/dwsscript/instances/a1ad-448a-9d56-4154193d49c5

响应示例

  • 成功响应

    HTTP状态码 200

    {
	"results": [{
		"message": "",
                "duration":0.5,
		"rowCount": 1,
		"rows": [[913460.0,
		765.0,
		"8/31/2015 23:26",
		"Harry Bridges Plaza (Ferry Building)",
		50.0,
		"8/31/2015 23:39",
		"San Francisco Caltrain (Townsend at 4th)",
		70.0,
		"288",
		"Subscriber",
		"2139"]],
		"schema": [{
			"TripID": "int"
		},
		{
			"Duration": "int"
		},
		{
			"StartDate": "string"
		},
		{
			"StartStation": "string"
		},
		{
			"StartTerminal": "int"
		},
		{
			"EndDate": "string"
		},
		{
			"EndStation": "string"
		},
		{
			"EndTerminal": "int"
		},
		{
			"Bike": "string"
		},
		{
			"SubscriberType": "string"
		},
		{
			"ZipCode": "string"
		}]
	}],
	"status": "FINISHED"
}
  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.6201",
    "error_msg":"The script does not exist."
}

状态码

状态码请参见状态码。

父主题： 脚本开发API

相关文档