获取任务列表 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=ListTasks&groupName=%E4%BB%BB%E5%8A%A1%E7%AE%A1%E7%90%86&serviceCode=las&version=2025-08-15) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：ListTasks` 要执行的操作，取值：ListTasks。 **Version** string 必选 `示例值：2025-08-15` API的版本，取值：2025\-08\-15。 **SortBy** string `可选` `示例值：CreateTime` 排序字段 **TaskIds** string[] `可选` `示例值：[ "taskId1", "taskId2" ]` 任务 Id 数组 **OwnerIds** long[] `可选` `示例值：[ 123, 456 ]` 子账号(创建者) Id 列表 **TaskName** string `可选` `示例值：taskName` 任务名，模糊查找 **NextToken** string `可选` `示例值：nextToken` 下一次查询起始Id（不包含）或页码（默认为0） **SortOrder** string `可选` `示例值：Desc` 排序顺序 **TaskTypes** string[] `可选` `示例值：[ "Daft", "Python" ]` 任务类型数组 **MaxResults** integer `可选` `示例值：10` 单页记录数 **ClientToken** string `可选` `示例值：uuid-xxxxxx` 客户端token ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **Items** object[] `示例值：参见下文数据结构章节` 概要列表 **Name** string `示例值：test_name` 任务名称 **TaskId** string `示例值：t-uuid` 任务 Id **OwnerId** long `示例值：123456` 创建者账号 Id **TaskType** string `示例值：Daft` 任务类型 **AccountId** long `示例值：123456` 主账号 Id **OwnerName** string `示例值：123456` 创建者名称 **CreateTime** string `示例值：2025-01-01T01:01:01Z` 创建时间，参照《ISO 8601\-2:2019》标准 **UpdateTime** string `示例值：2025-01-01T01:01:01Z` 更新时间，参照《ISO 8601\-2:2019》标准 **Description** string `示例值：for test` 注释说明 **SchedulerStatus** string `示例值：Enabled` 定时调度是否开启 **NextToken** string `示例值：0` 分页查询的下一页token **MaxResults** integer `示例值：10` 单次查询可返回的最大记录数 **TotalCount** long `示例值：100` 总记录数 ## 请求示例 ```text POST https://open.volcengineapi.com { "SortBy": "CreateTime", "TaskIds": [ "taskId1", "taskId2" ], "OwnerIds": [ 123, 456 ], "TaskName": "taskName", "NextToken": "nextToken", "SortOrder": "Desc", "TaskTypes": [ "Daft", "Python" ], "MaxResults": 10, "ClientToken": "uuid-xxxxxx" } ``` ## 返回示例 ```text { "Result": { "Items": [ { "Name": "test_name", "TaskId": "t-uuid", "OwnerId": 123456, "TaskType": "Daft", "AccountId": 123456, "OwnerName": "123456", "CreateTime": "2025-01-01T01:01:01Z", "UpdateTime": "2025-01-01T01:01:01Z", "Description": "for test" } ], "NextToken": "0", "MaxResults": 10, "TotalCount": 100 }, "ResponseMetadata": { "Action": "ListTasks", "Region": "cn-beijing", "Service": "las_ai_qa", "Version": "2025-08-15", "RequestId": "20230604110420****100232280022D31", "Deprecated": true } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |MissingParameter |The required parameter {} is missing. |缺少必需的参数 {}。 | |400 |InvalidParameter |The specified parameter {} is invalid. |指定的参数 {} 无效。 | |400 |DryRunOperation |The request is validated by a dryrun operation. |该请求通过 dryrun 操作进行验证。 | |400 |InvalidRequestParam |Invalid request param {}, cause {} |非法请求参数 {}, 原因 {} | |500 |InternalError |The request has failed due to an unknown error. |由于未知错误，请求失败。 |

AI 数据湖服务