文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 评估/ TMS标签管理/ 批量删除数据集TMS标签 - BatchDeleteOpsDatasetTags
更新时间：2026-09-14 GMT+08:00
查看PDF
分享

批量删除数据集TMS标签 - BatchDeleteOpsDatasetTags

功能介绍

该接口用于批量删除指定数据集的TMS标签。

调用方法

请参见如何调用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 /v1/datasets/{dataset_id}/tags/delete

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

是

String

参数解释：

评测集的唯一标识符（ID）

约束限制：

由英文、数字、“-”、“”组成，长度为1到64个字符。 取值范围： 由英文字母、数字、连字符(-)、下划线()组成的1~64个字符的字符串。

默认取值：

无。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

是

Array of OpsTmsTag objects

参数解释：

批量操作的自定义标签列表。key不允许重复。

约束限制：

数组元素最小数量为1，最大数量为50。

取值范围：

不涉及。

默认取值：

不涉及。
表3 OpsTmsTag

参数

是否必选

参数类型

描述

key

否

String

参数解释：

标签键名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

value

否

String

参数解释：

标签值，存储该标签键对应的具体内容。

约束限制：

不涉及。

取值范围：

由任意字符组成，长度为0~256个字符。

默认取值：

不涉及。

响应参数

状态码：204

无

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释：

错误详情列表，包含多个子错误的详细信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求的唯一标识符，用于问题排查和链路追踪。

取值范围：

符合通用唯一识别码(UUID)标准的字符串。
表5 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释：

子错误的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对子错误的详细描述。

取值范围：

任意文本内容。

状态码：401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释：

错误详情列表，包含多个子错误的详细信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求的唯一标识符，用于问题排查和链路追踪。

取值范围：

符合通用唯一识别码(UUID)标准的字符串。
表7 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释：

子错误的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对子错误的详细描述。

取值范围：

任意文本内容。

状态码：403

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释：

错误详情列表，包含多个子错误的详细信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求的唯一标识符，用于问题排查和链路追踪。

取值范围：

符合通用唯一识别码(UUID)标准的字符串。
表9 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释：

子错误的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对子错误的详细描述。

取值范围：

任意文本内容。

状态码：404

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释：

错误详情列表，包含多个子错误的详细信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求的唯一标识符，用于问题排查和链路追踪。

取值范围：

符合通用唯一识别码(UUID)标准的字符串。
表11 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释：

子错误的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对子错误的详细描述。

取值范围：

任意文本内容。

状态码：429

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释：

错误详情列表，包含多个子错误的详细信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求的唯一标识符，用于问题排查和链路追踪。

取值范围：

符合通用唯一识别码(UUID)标准的字符串。
表13 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释：

子错误的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对子错误的详细描述。

取值范围：

任意文本内容。

状态码：500

表14 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释：

错误详情列表，包含多个子错误的详细信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求的唯一标识符，用于问题排查和链路追踪。

取值范围：

符合通用唯一识别码(UUID)标准的字符串。
表15 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释：

子错误的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对子错误的详细描述。

取值范围：

任意文本内容。

请求示例

无

响应示例

状态码：204

无

状态码：400

{
  "error_code" : "AgentArts.03400001",
  "error_msg" : "请求错误"
}

状态码：401

{
  "error_code" : "AgentArts.100004010",
  "error_msg" : "unauthorized"
}

状态码：403

{
  "error_code" : "AgentArts.100004030",
  "error_msg" : "forbidden"
}

状态码：404

{
  "error_code" : "AgentArts.100004040",
  "error_msg" : "数据集不存在"
}

状态码：429

{
  "error_code" : "AgentArts.100004290",
  "error_msg" : "请求过于频繁"
}

状态码：500

{
  "error_code" : "AgentArts.03500001",
  "error_msg" : "internal error"
}

状态码

状态码

描述

204

删除成功

400

请求参数错误

401

认证失败

403

鉴权失败

404

数据集不存在

429

请求过于频繁

500

系统错误

错误码

请参见错误码。

父主题： TMS标签管理

相关文档