为指定资源类型添加标签 - CreateTagResource

功能介绍

向指定的资源类型添加一个或多个标签。目前，您可以将标签附加到组织中的账号、组织单元、根和策略。此操作只能由组织的管理账号调用。

调试

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

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

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

URI

POST /v1/organizations/{resource_type}/{resource_id}/tags/create

表1 路径参数
参数	是否必选	参数类型	描述
resource_type	是	String	参数解释：资源类型。枚举值：organizations:policies（服务策略）、organizations:ous（组织OU）、organizations:accounts（账号信息）、organizations:roots：（根）。约束限制：必填取值范围：枚举值："organizations:policies"、"organizations:ous"、"organizations:accounts"、"organizations:roots"。默认取值：无默认值
resource_id	是	String	参数解释：根、组织单元、账号或策略的唯一标识符（ID）。约束限制：必填取值范围：符合正则表达式：^(?:r-[0-9a-z]{4,32}\|[\w-]+\|ou-[0-9a-z]{8,32}\|p-[0-9a-zA-Z_]{8,128})$ 最大长度130。默认取值：无默认值

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Security-Token	否	String	参数解释：如果正在使用临时安全凭据，则此 header 是必需的，该值是临时安全凭据的安全令牌（会话令牌）。约束限制：不涉及取值范围：最小长度0、最大长度32768。默认取值：无默认值

表3 请求Body参数
参数	是否必选	参数类型	描述
tags	是	Array of TagDto objects	参数解释：要添加到指定资源的标签列表。约束限制：必填字段取值范围：最少1个、最多20个。默认取值：无默认值

表4 TagDto
参数	是否必选	参数类型	描述
key	是	String	参数解释：标签键的密钥标识符或名称。约束限制：必填字段取值范围：符合正则表达式：^((?!sys\|\s)[\p{L}\p{Z}\p{N}.:=+-@][\p{L}\p{N}.:=+-@])$ 最小长度1、最大长度128。默认取值*：无
value	是	String	参数解释：与标签键关联的字符串值。您可以将标签的值设置为空字符串，但不能将标签的值设置为NULL。约束限制：必填字段取值范围：符合正则表达式：^([\p{L}\p{Z}\p{N}_.:/=+-@])$ 最小长度0、最大长度255。默认取值*：无

响应参数

状态码：200

Successful.

无

请求示例

为指定资源类型添加标签

POST https://{endpoint}/v1/organizations/{resource_type}/{resource_id}/tags/create

{
  "tags" : [ {
    "key" : "keystring",
    "value" : "valuestring"
  } ]
}