文档首页/ 应用服务网格 ASM/ API参考/ API/ 标签接口/ 批量创建标签 - CreateTags
更新时间：2026-02-02 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量创建标签 - CreateTags

功能介绍

该API用于批量创建标签

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    asm:mesh:tagResource

    Tagging

    mesh *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    -

    -

    -

    • g:TagKeys

    • g:RequestTag/<tag-key>

URI

POST /v2/{projectid}/{resourcetype}/{resourceid}/tags/create

表1 路径参数

参数

是否必选

参数类型

描述

projectid

是

String

项目ID

resourcetype

是

String

资源类型，目前仅支持"asm-mesh"

resourceid

是

String

资源ID，即网格ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式）。

取值范围：

  • application/json;charset=utf-8：指定内容为JSON格式，并以UTF8字符编码进行编码

  • application/json：指定内容为JSON格式

X-Auth-Token

是

String

调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。
表3 请求Body参数

参数

是否必选

参数类型

描述

tags

否

Array of resource_tag objects

标签列表

租户权限时该字段必选，op_service权限时和sys_tags二选一

sys_tags

否

Array of resource_tag objects

系统标签列表

仅系统标签使用
表4 resource_tag

参数

是否必选

参数类型

描述

key

是

String

键。最大长度128个字符。

key需要满足3.1 KEY字符集规范

value

是

String

值。每个值最大长度255个字符， value需要满足3.2 VALUE字符集规范

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

-

String

创建标签成功

状态码：400

表6 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

errorMsg

String

错误描述

状态码：500

表7 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

errorMsg

String

错误描述

请求示例

无

响应示例

无

状态码

状态码

描述

200

创建标签成功

400

参数错误，创建标签失败

500

内部错误

错误码

请参见错误码。

父主题： 标签接口

相关文档