文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 智能体优化/ 优化标签管理/ 根据标签查询智能体优化任务列表 - ListOpsAgentTuningTasksByTags
更新时间:2026-11-09 GMT+08:00
分享

根据标签查询智能体优化任务列表 - ListOpsAgentTuningTasksByTags

功能介绍

根据标签查询智能体优化任务列表。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::listResourcesByTag

List

-

g:TagKeys

-

-

URI

POST https://agentarts.region_id.myhuaweicloud.com/v1/agent-tuning-tasks/resource-instances/filter

表1 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

参数解释:

索引位置偏移量,用于指定从第几条记录开始返回,单位:条(记录数)。

约束限制:

不涉及

取值范围:

大于等于0且小于等于100000的整数。

默认取值:

0

limit

否

Integer

参数解释:

查询记录数,表示单页返回的最大任务数,单位:条。

约束限制:

不涉及

取值范围:

1到100的正整数。

默认取值:

10

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

without_any_tag

否

Boolean

参数解释:

是否查询所有不带标签的资源。

约束限制:

不涉及。

取值范围:

  • true:查询所有不带标签的资源,此时忽略 “tags”字段;

  • false:返回所有资源或按“tags”、“matches”等条件过滤。

默认取值:

false。

tags

否

Array of OpsTasksTagValuesForTMS objects

参数解释:

指定查询的资源中需要包含哪些标签,结果返回包含所有标签的资源列表,key之间是与的关系,key-value结构中value是或的关系。

约束限制:

数组内key不能重复,同一个key中values不能重复,每个key对应的value可以为空数组但结构体不能缺失,数组长度最大为20。

取值范围:

不涉及。

默认取值:

不涉及。

matches

否

Array of OpsTasksTagForTMS objects

参数解释:

标签键值匹配字段,key为要匹配的字段。

约束限制:

key为固定字典值,只支持resource_name,不能包含重复的key或不支持的key。支持根据value的值做前缀搜索,数组长度最大为20。

取值范围:

不涉及。

默认取值:

不涉及。

表3 OpsTasksTagValuesForTMS

参数

是否必选

参数类型

描述

key

是

String

参数解释:

标签键。

约束限制:

key不能为空或者空字符串,不能为空格。

取值范围:

最小长度1,最大长度128个unicode字符。

默认取值:

不涉及。

values

是

Array of strings

参数解释:

标签值列表,数组长度0-20,每个值最大长度255个unicode字符。

约束限制:

如果values为空列表,则表示查询任意value。value之间为或的关系。

取值范围:

不涉及。

默认取值:

不涉及。

表4 OpsTasksTagForTMS

参数

是否必选

参数类型

描述

key

是

String

参数解释:

标签键,标识资源的分类维度。

约束限制:

不能为空或者空字符串,不能为空格,校验和使用之前先trim前后半角空格。最大长度128个unicode字符。

取值范围:

最小长度1,最大长度128个unicode字符。

默认取值:

无

value

是

String

参数解释:

标签值,具体的分类值。

约束限制:

不校验字符集范围。

取值范围:

不校验字符集范围。最小长度0,最大长度255个unicode字符。

默认取值:

无

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

total_count

Integer

参数解释:

总记录数。

取值范围:

非负整数。

resources

Array of OpsTasksResourceInstanceForTMS objects

参数解释:

根据标签查询的资源实例列表,数组长度0-1000。

取值范围:

不涉及。

表6 OpsTasksResourceInstanceForTMS

参数

参数类型

描述

resource_id

String

参数解释:

资源实例ID。

取值范围:

无。

resource_name

String

参数解释:

资源实例名称。

取值范围:

无。

tags

Array of OpsTasksTagForTMS objects

参数解释:

资源标签列表,没有标签默认为空数组,数组长度为0-20。

取值范围:

不涉及。

resource_detail

Object

参数解释:

资源详情,资源对象用于扩展。默认为空。

取值范围:

不涉及。

表7 OpsTasksTagForTMS

参数

参数类型

描述

key

String

参数解释:

标签键,标识资源的分类维度。

取值范围:

最小长度1,最大长度128个unicode字符。

value

String

参数解释:

标签值,具体的分类值。

取值范围:

不校验字符集范围。最小长度0,最大长度255个unicode字符。

状态码:400

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:401

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:403

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:机器可读的错误代码。

取值范围:系统错误码字符串。

error_msg

String

参数解释:人类可读的错误消息。

取值范围:详细错误说明字符串。

encoded_authorization_message

String

参数解释:编码后的授权失败信息。

取值范围:字符串。

details

Array of OpsRLCommonError objects

参数解释:依赖的下游服务错误信息列表。

取值范围:包含error_code和error_msg的对象数组。

表11 OpsRLCommonError

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:404

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:429

表13 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:500

表14 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

请求示例

根据标签精确查询智能体优化任务

POST /v1/agent-tuning-tasks/resource-instances/filter

{
  "without_any_tag" : false,
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1" ]
  } ]
}

响应示例

状态码:200

根据标签查询智能体优化任务列表成功。

{
  "total_count" : 1,
  "resources" : [ {
    "resource_id" : "f1e2d3c4b5a6978809a1b2c3d4e5f6a7",
    "tags" : [ {
      "key" : "key1",
      "value" : "value1"
    } ],
    "resource_name" : "agent-tuning-task"
  } ]
}

状态码

状态码

描述

200

根据标签查询智能体优化任务列表成功。

400

请求参数错误。

401

认证失败。

403

权限不足。

404

智能体优化任务或目标服务未找到

429

请求频率超限。

500

内部服务器错误

错误码

请参见错误码。

相关文档