AI 数据湖服务
AI 数据湖服务
开发参考
请输入
- 文档首页
AI 数据湖服务API 参考：管控面任务管理ListTaskInstances - 列举任务实例概要信息
复制全文
下载 pdfListTaskInstances - 列举任务实例概要信息
文档反馈
问问助手列举任务实例概要信息
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ListTaskInstances
要执行的操作，取值：ListTaskInstances。
Version string 必选 示例值：2025-08-15
API的版本，取值：2025-08-15。
SortBy string 可选 示例值：CreateTime
排序字段
TaskIds string[] 可选 示例值：t-uuid1,t-uuid2
任务 Id 数组
OwnerIds long[] 可选 示例值：123,456
实例启动者 Id 列表
Statuses string[] 可选 示例值：Created,Processing
任务实例状态数组, Created(已创建)/Submitting(提交中)/ResourceInitializing(启动中)/Processing(处理中)/Completed(已完成)/Cancelled(已取消)/Failed(运行失败)/SubmitFailed(提交失败)/AnalysisFailed(解析失败)
NextToken string 可选 示例值：nextToken
下一次查询起始Id（不包含）或页码（默认为0）
SortOrder string 可选 示例值：Desc
排序顺序
MaxResults integer 可选 示例值：10
单页记录数
ClientToken string 可选 示例值：uuid-xxxxxx
客户端token
RunOwnerIds long[] 可选 示例值：[ 123, 456 ]
实例启动者 Id 列表
TriggerTypes string[] 可选 示例值：Manual
触发方式, Manual(手动触发)/Cron(定时触发)/Workflow(工作流触发)
TaskInstanceIds string[] 可选 示例值：ti-uuid1,ti-uuid2
实例 Id 数组
返回参数
Items object[] 示例值：--
概要列表
Status string 示例值：Completed
任务状态。Created(已创建)/Submitting(提交中)/ResourceInitializing(启动中)/Processing(处理中)/Completed(已完成)/Cancelled(已取消)/Failed(运行失败)/SubmitFailed(提交失败)/AnalysisFailed(解析失败)
TaskId string 示例值：t-uuid
实例所属任务 Id
OwnerId long 示例值：123456
创建者子账号 Id
TaskType string 示例值：Daft
任务类型
AccountId long 示例值：123456
主账号 Id
OwnerName string 示例值：name
创建者子账号name
CreateTime string 示例值：2025-01-01T01:01:01Z
创建时间，参照《ISO 8601-2:2019》标准
FinishTime string 示例值：2025-01-01T01:01:01Z
结束时间，参照《ISO 8601-2:2019》标准
RunOwnerId long 示例值：123456
执行者子账号 Id
UpdateTime string 示例值：2025-01-01T01:01:01Z
更新时间，参照《ISO 8601-2:2019》标准
TriggerType string 示例值：Manual
触发方式, Manual-手动触发; Cron-定时触发; Workflow-工作流触发
RunOwnerName string 示例值：name
执行者子账号name
CancelOwnerId long 示例值：123456
取消者子账号 Id
TaskInstanceId string 示例值：ti-uuid
任务实例 Id
CancelOwnerName string 示例值：name
取消者子账号name
StateChangeReason string 示例值：Failed reason
最终状态失败原因
JobId string 示例值：123456
底层 Job Id
NextToken string 示例值：0
分页查询的下一页token
MaxResults integer 示例值：10
单次查询可返回的最大记录数
TotalCount long 示例值：100
总记录数
请求示例
POST https://open.volcengineapi.com
{
"SortBy": "CreateTime",
"TaskIds": [
"t-uuid1",
"t-uuid2"
],
"OwnerIds": [
123,
456
],
"Statuses": [
"Created",
"Processing"
],
"NextToken": "nextToken",
"SortOrder": "Desc",
"MaxResults": 10,
"ClientToken": "uuid-xxxxxx",
"TriggerTypes": [
"Manual"
],
"TaskInstanceIds": [
"i-uuid1",
"i-uuid2"
]
}
返回示例
{
"ResponseMetadata": {
"RequestId": "2025112517201724203411616584B748",
"Action": "ListTaskInstances",
"Version": "2025-08-15",
"Service": "las_ai_qa",
"Region": "cn-beijing"
},
"Result": {
"Items": [
{
"Status": "Completed",
"TaskId": "t-uuid",
"OwnerId": 123456,
"TaskType": "Daft",
"AccountId": 123456,
"OwnerName": "name",
"CreateTime": "2025-01-01T01:01:01Z",
"FinishTime": "2025-01-01T01:01:01Z",
"RunOwnerId": 123456,
"UpdateTime": "2025-01-01T01:01:01Z",
"TriggerType": "Manual",
"RunOwnerName": "name",
"CancelOwnerId": 123456,
"TaskInstanceId": "ti-uuid",
"CancelOwnerName": "name",
"StateChangeReason": "Failed reason"
}
],
"NextToken": "0",
"MaxResults": 10,
"TotalCount": 439
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | DryRunOperation | The request is validated by a dryrun operation. | 该请求通过 dryrun 操作进行验证。 |
400 | InvalidParameter | The specified parameter {} is invalid. | 指定的参数 {} 无效。 |
400 | MissingParameter | The required parameter {} is missing. | 缺少必需的参数 {}。 |
400 | InvalidRequestParam | Invalid request param {}, cause {} | 非法请求参数 {}, 原因 {} |
500 | InternalError | The request has failed due to an unknown error. | 由于未知错误，请求失败。 |
最近更新时间：2026.08.10 16:47:46
这个页面对您有帮助吗？
有用
有用
无用
无用