根据标签查询智能体优化任务列表 - 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
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 否 | Integer | 参数解释: 索引位置偏移量,用于指定从第几条记录开始返回,单位:条(记录数)。 约束限制: 不涉及 取值范围: 大于等于0且小于等于100000的整数。 默认取值: 0 |
| limit | 否 | Integer | 参数解释: 查询记录数,表示单页返回的最大任务数,单位:条。 约束限制: 不涉及 取值范围: 1到100的正整数。 默认取值: 10 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| without_any_tag | 否 | Boolean | 参数解释: 是否查询所有不带标签的资源。 约束限制: 不涉及。 取值范围: 默认取值: 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。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total_count | Integer | 参数解释: 总记录数。 取值范围: 非负整数。 |
| resources | Array of OpsTasksResourceInstanceForTMS objects | 参数解释: 根据标签查询的资源实例列表,数组长度0-1000。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| resource_id | String | 参数解释: 资源实例ID。 取值范围: 无。 |
| resource_name | String | 参数解释: 资源实例名称。 取值范围: 无。 |
| tags | Array of OpsTasksTagForTMS objects | 参数解释: 资源标签列表,没有标签默认为空数组,数组长度为0-20。 取值范围: 不涉及。 |
| resource_detail | Object | 参数解释: 资源详情,资源对象用于扩展。默认为空。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | String | 参数解释: 标签键,标识资源的分类维度。 取值范围: 最小长度1,最大长度128个unicode字符。 |
| value | String | 参数解释: 标签值,具体的分类值。 取值范围: 不校验字符集范围。最小长度0,最大长度255个unicode字符。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 机器可读的错误代码。 取值范围: 系统错误码字符串。 |
| error_msg | String | 参数解释: 人类可读的错误消息。 取值范围: 详细错误说明字符串。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 机器可读的错误代码。 取值范围: 系统错误码字符串。 |
| error_msg | String | 参数解释: 人类可读的错误消息。 取值范围: 详细错误说明字符串。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释:机器可读的错误代码。 取值范围:系统错误码字符串。 |
| error_msg | String | 参数解释:人类可读的错误消息。 取值范围:详细错误说明字符串。 |
| encoded_authorization_message | String | 参数解释:编码后的授权失败信息。 取值范围:字符串。 |
| details | Array of OpsRLCommonError objects | 参数解释:依赖的下游服务错误信息列表。 取值范围:包含error_code和error_msg的对象数组。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 机器可读的错误代码。 取值范围: 系统错误码字符串。 |
| error_msg | String | 参数解释: 人类可读的错误消息。 取值范围: 详细错误说明字符串。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 机器可读的错误代码。 取值范围: 系统错误码字符串。 |
| error_msg | String | 参数解释: 人类可读的错误消息。 取值范围: 详细错误说明字符串。 |
状态码:429
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 机器可读的错误代码。 取值范围: 系统错误码字符串。 |
| error_msg | String | 参数解释: 人类可读的错误消息。 取值范围: 详细错误说明字符串。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 内部服务器错误 |
错误码
请参见错误码。