# 查询评估任务的自定义标签值 - ListOpsEvaluationTaskCustomLabelValues
#### 功能介绍
该接口用于查询评估任务的自定义标签值，支持按标签ID和项目ID进行过滤查询，适用于标签数据查询和分析的场景。
#### 调用方法
请参见[如何调用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:listOpsEvaluationTaskCustomLabelValues | List | evaluationTask \* | g:ResourceTag/\<tag-key\> | -  | -      |
   
#### URI
GET /v1/ops/evaluation-tasks/{task_id}/custom-labels-values
表1路径参数 
| 参数      | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| task_id | 是    | String | **参数解释：** 评估任务的唯一标识符（ID）。可通过调用创建评估任务接口获取，或通过查询评估任务列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。 |
   
表2Query参数 
| 参数      | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| tag_id  | 否    | String  | **参数解释：** 标签的唯一标识符（ID）。可通过查询标签列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及连字符(-)组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。                           |
| item_id | 否    | String  | **参数解释：** 评测集条目的唯一标识符（ID）。可通过查询评测集条目列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及连字符(-)组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。                     |
| offset  | 否    | Integer | **参数解释：** 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与 limit参数配合实现分页功能。 **约束限制：** 需与limit参数配合使用实现分页查询功能，不设置时默认从第0条开始返回。 **取值范围：** 0\~10000。 **默认取值：** 0。 |
| limit   | 否    | Integer | **参数解释：** 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 **约束限制：** 需与offset参数配合使用实现分页查询功能，不设置时默认每页返回10条记录。 **取值范围：** 1\~100。 **默认取值：** 10。                 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
返回评估任务的自定义标签值
无
#### 请求示例
查询评估任务的自定义标签值
```
GET https://api.example.com/v1/ops/evaluation-tasks/1769499746650415700514/custom-labels-values
```
#### 响应示例
**状态码：200**
返回评估任务的自定义标签值
```
{
  "body" : {
    "data" : [ {
      "id" : "69dd96e28d71a0ed771dca86",
      "task_id" : "31f26847-58c0-4966-b3b4-2141d217f433",
      "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
      "tag_id" : "639a0c3e-28ce-4949-9614-71e46e790ea3",
      "tag_type" : "free_text",
      "item_id" : "69dc48fe683ed580dd4641c6",
      "annotated_value" : "52",
      "created_at" : "2026-04-14T01:22:42.192Z",
      "updated_at" : "2026-04-14T01:22:42.192Z",
      "is_delete" : false
    }, {
      "id" : "69dd96e28d71a0ed771dca87",
      "task_id" : "31f26847-58c0-4966-b3b4-2141d217f433",
      "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
      "tag_id" : "639a0c3e-28ce-4949-9614-71e46e790ea3",
      "tag_type" : "free_text",
      "item_id" : "69dc48fe683ed580dd4641c4",
      "annotated_value" : "52",
      "created_at" : "2026-04-14T01:22:42.192Z",
      "updated_at" : "2026-04-14T01:22:42.192Z",
      "is_delete" : false
    } ],
    "msg" : "query succeed",
    "total" : 10
  }
}
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | 返回评估任务的自定义标签值 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。