You need to enable JavaScript to run this app.
文档中心
AI 数据湖服务

AI 数据湖服务

复制全文
下载 pdf
任务管理
ListTaskInstances - 列举任务实例概要信息
复制全文
下载 pdf
ListTaskInstances - 列举任务实例概要信息
列举任务实例概要信息​
调试​
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
这个页面对您有帮助吗?
有用
有用
无用
无用