添加或者覆盖一个或者多个标签到云服务器ECS的各项资源上。您可以添加标签到实例、磁盘、快照、镜像、安全组等,便于管理资源。

描述

调用该接口时,您需要注意:
  • 单项云服务器ECS资源最多可以添加20个标签。
  • 标签键(Tag.n.Key)与标签值(Tag.n.Value)必须键值匹配。

  • 如果标签键(Tag.n.Key)在指定的资源上已经存在,则使用新的标签值(Tag.n.Value)自动覆盖原标签值。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:AddTags
RegionId String 资源所在的地域。您可以调用DescribeRegions查看最新的阿里云地域列表。
ResourceType String 资源类型。取值范围:
  • disk
  • instance
  • image
  • securitygroup
  • snapshot
以上取值均为小写。
ResourceId String 要绑定标签的资源ID。例如,当资源类型(ResourceType)为实例(instance)时,资源ID可以理解为实例ID。
Tag.n.Key String 资源的标签键。n的取值范围:[1, 20]。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以aliyun、acs:、http://或者https://开头。
Tag.n.Value String

资源的标签值。n的取值范围:[1, 20]。一旦使用标签,该值可以为空字符串。最多支持128个字符,不能以aliyun、acs:、http://或者https://开头。

返回参数

全是公共返回参数。参阅公共返回参数

示例

请求示例
https://ecs.aliyuncs.com/?Action=AddTags
&ResourceId=s-946ntx4wr
&ResourceType=snapshot
&RegionId=cn-shenzhen
&Tag.1.Key=test
&Tag.1.Value=api
&<公共请求参数>
返回示例

XML格式

<AddTagsResponse>
    <RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</AddTagsResponse>
JSON格式
{
  "RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

错误码

以下为本接口特有的错误码。更多错误码,请访问API错误中心

错误代码 错误信息 HTTP状态码 说明
InvalidTag.Mismatch The specified Tag.n.Key and Tag.n.Value are not match. 400 标签键(Tag.n.Key)与标签值(Tag.n.Value)必须键值匹配。
InvalidTagCount The specified tags are beyond the permitted range. 400 指定的标签数不能超过20个。
InvalidTagKey.Malformed The specified Tag.n.Key is not valid. 400 指定的Tag.n.Key不合法。
InvalidTagValue.Malformed The specified Tag.n.Value is not valid. 400 指定的Tag.n.Value不合法。
OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range. 400 单项云服务器ECS资源最多可以绑定20个标签。
InvalidResourceId.NotSupported The specified ResourceId does not support tagging. 403 指定的资源不支持标签功能。
InvalidRegionId.NotFound The RegionId provided does not exist in our records. 404 指定的RegionId不存在。
InvalidResourceId.NotFound The specified ResourceId is not found in our records. 404 指定的ResourceId不存在。
InvalidResourceType.NotFound The ResourceType provided does not exist in our records. 404 指定的ResourceType不存在。