文档首页/ AI开发平台ModelArts/ API参考/ 训练管理/ 创建训练作业标签
更新时间：2025-09-18 GMT+08:00
查看PDF
分享

创建训练作业标签

功能介绍

创建训练作业标签，支持批量添加，当添加的标签key已存在，则覆盖该标签的value。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/trainJob/{training_job_id}/tags/create

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：用户项目ID。获取方法请参见获取项目ID和名称。

约束限制：1 - 64字符，字母、数字和中划线。

取值范围：不涉及。

默认取值：不涉及。

training_job_id

是

String

参数解释：训练作业ID。

约束限制：获取方法请参见查询训练作业列表。

取值范围：不涉及。

默认取值：不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

是

Array of TmsTag objects

参数解释：TMS标签列表。

约束限制：不涉及。
表3 TmsTag

参数

是否必选

参数类型

描述

key

是

String

参数解释：TMS标签的key。

约束限制：不涉及。

取值范围：长度限制为128个字符，支持任意语种字母、数字、空格，以及_ . : = + - @特殊字符，但首尾不能含有空格，不能以_sys_开头。

默认取值：不涉及。

value

是

String

参数解释：TMS标签的value。

约束限制：不涉及。

取值范围：长度限制为255个字符，支持任意语种字母、数字、空格，以及_ . : / = + - @特殊字符。

默认取值：不涉及。

响应参数

状态码：204

表4 响应Body参数

参数

参数类型

描述

tags

Array of TmsTag objects

参数解释：TMS标签列表。

约束限制：不涉及。
表5 TmsTag

参数

参数类型

描述

key

String

参数解释：TMS标签的key。

约束限制：不涉及。

取值范围：长度限制为128个字符，支持任意语种字母、数字、空格，以及_ . : = + - @特殊字符，但首尾不能含有空格，不能以_sys_开头。

默认取值：不涉及。

value

String

参数解释：TMS标签的value。

约束限制：不涉及。

取值范围：长度限制为255个字符，支持任意语种字母、数字、空格，以及_ . : / = + - @特殊字符。

默认取值：不涉及。

请求示例

创建训练作业标签。设置TMS标签的key/value为“111”和“k3”，TMS标签的key/value为"k3"和“v2”。

POST    https://endpoint/v2/{project_id }/trainJob/{training_job_id}/tags/create

{
  "tags" : [ {
    "key" : "111",
    "value" : "v2"
  }, {
    "key" : "k3",
    "value" : "v2"
  } ]
}

响应示例

状态码：204

添加成功。

{
  "tags" : [ {
    "key" : "111",
    "value" : "v2"
  }, {
    "key" : "k3",
    "value" : "v2"
  } ]
}

状态码

状态码

描述

204

添加成功。

错误码

请参见错误码。

父主题： 训练管理

相关文档