更新时间：2026-09-18 GMT+08:00

向指定资源添加标签 - TagResource

向指定资源添加标签。

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

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
AccessAnalyzer::tagResource	Tagging	analyzer *	g:ResourceTag/<tag-key>	-	-
AccessAnalyzer::tagResource	Tagging	-	g:RequestTag/<tag-key> g:TagKeys	-	-

POST /v5/{resource_type}/{resource_id}/tags/create

表1 路径参数
参数	是否必选	参数类型	描述
resource_type	是	String	参数解释：资源类型。取值范围： analyzers: 分析器约束限制：不涉及。默认取值：不涉及。
resource_id	是	String	参数解释：资源的唯一标识符。您可以调用 ListFindings API来检索指定分析器生成的分析结果列表。该API的响应中会包含一个分析结果列表，列表中的每个分析结果对象都包含其分析的资源信息，其中的resource字段即为该资源的唯一标识符（资源ID）。取值范围：最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）和中划线（-）。

表2 请求Body参数
参数	是否必选	参数类型	描述
tags	是	Array of Tag objects	参数解释：自定义标签列表。约束限制：不涉及。取值范围：数组长度为1到20。默认取值：不涉及。

表3 Tag
参数	是否必选	参数类型	描述
key	是	String	参数解释：标签键。约束限制：不能以 _sys_ 开头，首尾不能包含空格。取值范围：最小长度为1，最大长度为128。支持包含Unicode字母、数字、空格及特殊字符（_ . : = + - @）。默认取值：不涉及。
value	是	String	参数解释：与标签键关联的字符串值。约束限制：不涉及。取值范围：最小长度为0，最大长度为255。支持包含Unicode字母、数字、空格及特殊字符（_ . : %%= + - @）。默认取值：不涉及。

状态码：200

无

向指定资源添加标签。

POST https://{hostname}/v5/{resource_type}/{resource_id}/tags/create

{
  "tags" : [ {
    "key" : "key-1",
    "value" : "value-1"
  } ]
}

无

状态码	描述
200	OK

请参见错误码。

父主题： 标签