文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 智能体优化/ 优化标签管理/ 批量删除分析任务标签 - BatchDeleteOpsAnalysisTaskTags
更新时间:2026-11-09 GMT+08:00
分享

批量删除分析任务标签 - BatchDeleteOpsAnalysisTaskTags

功能介绍

批量删除分析任务标签。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::unTagResource

Tagging

modelTuningTask

g:ResourceTag/<tag-key>

-

-

agentTuningTask

g:ResourceTag/<tag-key>

analysisTask

g:ResourceTag/<tag-key>

-

  • g:RequestTag/<tag-key>

  • g:TagKeys

URI

POST https://agentarts.region_id.myhuaweicloud.com/v1/analysis-tasks/{analysis_task_id}/tags/delete

表1 路径参数

参数

是否必选

参数类型

描述

analysis_task_id

是

String

参数解释:

分析任务ID,标识任务的唯一标识符。获取方法请参考查询分析任务列表。

约束限制:

不涉及

取值范围:

长度为32的ID字符串,最小长度32,最大长度32。

默认取值:

无

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

否

Array of OpsTasksTagForPostTMS objects

参数解释:

标签键值对列表,默认为空数组。

约束限制:

数组内key不能重复,数组长度0-20。

取值范围:

不涉及。

默认取值:

不涉及。

表3 OpsTasksTagForPostTMS

参数

是否必选

参数类型

描述

key

是

String

参数解释:

标签键。

约束限制:

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

取值范围:

最大长度128个unicode字符,可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:_ . : / = + - @。

默认取值:

不涉及。

value

是

String

参数解释:

标签值。

约束限制:

value可以为空字符串。

取值范围:

最大长度255个unicode字符,可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:_ . : / = + - @。

默认取值:

不涉及。

响应参数

状态码:204

操作成功。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

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

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

error_msg

String

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

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

encoded_authorization_message

String

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

取值范围:字符串。

details

Array of OpsRLCommonError objects

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

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

表7 OpsRLCommonError

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:429

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

请求示例

批量删除分析任务标签

POST /v1/analysis-task/f1e2d3c4b5a6978809a1b2c3d4e5f6a7/tags/delete

{
  "tags" : [ {
    "key" : "appid",
    "value" : "testApp"
  } ]
}

响应示例

无

状态码

状态码

描述

204

操作成功。

400

请求参数错误。

401

认证失败。

403

权限不足。

404

分析任务或目标服务未找到

429

请求频率超限。

500

内部服务器错误

错误码

请参见错误码。

相关文档