# 查看评估任务列表 - ListOpsEvaluationTasks #### 功能介绍 该接口用于获取评估任务列表信息，支持条件筛选和分页查询，返回任务的基本信息和执行状态，适用于任务管理和监控的场景。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:evaluationTask:listOpsEvaluationTasks | List | evaluationTask \* | g:ResourceTag/\ | - | - | #### URI POST /v1/ops/evaluation-tasks/list #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 是 | Integer | **参数解释：** 指定每次请求返回的偏移量，即从第几条数据开始查询。 **约束限制：** offset与limit配合使用实现分页查询，offset表示从第几条数据开始查询，limit表示每页返回的记录数量。 **取值范围：** 1\~10000。 **默认取值：** 1。 | | limit | 是 | Integer | **参数解释：** 指定每页返回的记录数量（页大小）。 **约束限制：** 1到100之间的整数。 **取值范围：** 1到100。 **默认取值：** 10。 | | tag_key_exists | 否 | Array of strings | **参数解释：** 需要匹配的包含该标签名称的资源。 **约束限制：** 支持批量查询多个标签名，最多支持10个标签。 **取值范围：** 数组元素最小数量0，最大数量10。每个元素最大长度128。 **默认取值：** 不涉及。 | | tag_key_matches | 否 | Array of strings | **参数解释：** 需要匹配的包含该标签的资源，需要和tag_value_matches条件配合使用。 **约束限制：** tag_key_matches和tag_value_matches按索引位置配对。支持批量查询多个标签，最多支持10个标签。 **取值范围：** 数组元素最小数量0，最大数量10。每个元素最大长度128。 **默认取值：** 不涉及。 | | tag_value_matches | 否 | Array of strings | **参数解释：** 需要匹配的包含该标签值的资源，需要和tag_key_matches条件配合使用。 **约束限制：** tag_key_matches和tag_value_matches按索引位置配对。支持批量查询多个标签值，最多支持10个标签值。 **取值范围：** 数组元素最小数量0，最大数量10。每个元素最大长度255。 **默认取值：** 不涉及。 | | tag_match_policy | 否 | String | **参数解释：** 标签匹配模式，仅针对tag_key_exists、tag_key_matches、tag_value_matches参数生效。 - ALL: 所有标签都必须匹配 - ANY: 任意一个标签匹配即可 - ALL - ANY **约束限制：** 不涉及。 **取值范围：** 长度为1-3个字符。允许的值为： **默认取值：** ALL。 | #### 响应参数 **状态码：200** 请求成功 **状态码：400** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 系统定义的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对错误的详细描述，包含异常原因或解决建议。 **取值范围：** 字符长度2-512，任意文本内容。 | | encoded_authorization_message | String | **参数解释：** 编码后的授权信息，用于客户端解析权限问题。 **取值范围：** Base64编码的字符串。 | | details | Array of [OpsErrorDetail] objects | **参数解释：** 错误详情列表，包含多个子错误的详细信息。 **取值范围：** 不涉及。 | | request_id | String | **参数解释：** 请求的唯一标识符，用于问题排查和链路追踪。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | 表3OpsErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 子错误的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对子错误的详细描述。 **取值范围：** 任意文本内容。 | #### 请求示例 分页查询评估任务列表，通过设置offset和limit控制返回的数据范围，支持TMS标签过滤。 ``` POST https://api.example.com/v1/ops/evaluation-tasks/list { "offset" : 1, "limit" : 10, "tag_key_exists" : [ "env" ], "tag_key_matches" : [ "team" ], "tag_value_matches" : [ "ai-platform" ], "tag_match_policy" : "ALL" } ``` #### 响应示例 **状态码：200** 请求成功 ``` { "data" : { "total" : 3, "items" : [ { "id" : "1769499746650415700514", "name" : "hzx111asdf", "evaluation_object_type" : "workflow", "dataset_name" : "test1", "input_source_type" : "DATASET_STATIC", "status" : "PENDING", "created_at" : "2026-01-27T15:42:26.650415+08:00", "tags" : [ { "key" : "env", "value" : "prod" }, { "key" : "team", "value" : "ai-platform" } ] } ] } } ``` **状态码：400** 请求错误 ``` { "error_code" : "AgentArts.03400003", "error_msg" : "评估对象不存在" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求成功 | | 400 | 请求错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。