全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

AddTags

更新时间:2017-11-08 14:13:25

描述

给云资源绑定标签(Tag),便于管理。

  • 支持创建绑定在 ECS 实例、磁盘、快照、镜像、安全组等云资源的 Tag。
  • 单个云资源最多可以绑定 10 个 Tag。
  • 如果要绑定 Tag 的键(Key)在指定的资源上已经存在,则自动覆盖 Tag 的值(Value)。
  • 标签键(Tag.n.Key)与标签值(Tag.n.Value) 必须一一匹配。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:AddTags
RegionId String 云资源所在的地域。Region ID 的列表详见 地域列表 或者通过 API DescribeRegions 查看完整的地域列表。
ResourceId String 要创建 Tag 的资源 ID。
ResourceType String 资源类型。取值范围:
  • image
  • instance
  • snapshot
  • disk
  • securitygroup
所有值均为小写。
Tag.n.Key String 标签键,n 的取值范围为 [1, 5]。
最多支持 64 个字符
不支持 aliyun 开头
不支持 http:// 和 https:// 开头
不允许为空字符串。
Tag.n.Value String 标签值,n 的取值范围为 [1, 5]。
最多支持 128 个字符
不支持 aliyun 开头
不支持 http:// 和 https:// 开头
允许为空字符串。

返回参数

全是公共返回参数,详见公共参数

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidResourceId.NotFound The specified ResourceId is not found in our records. 404 指定的 ResourceId 不存在。
InvalidRegionId.NotFound The RegionId provided does not exist in our records. 404 指定的 RegionId 不存在。RegionId 的列表详见 地域列表
InvalidResourceType.NotFound The ResourceType provided does not exist in our records. 404 指定的 ResourceType 不存在。
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 资源上的用户 Tag 已经超过 10 个。
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 指定的 Tag 数超过了 5 个。
InvalidResourceId.NotSupported The specified ResourceId does not support tagging. 403 指定的资源 ID 不支持打 Tag。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=AddTags
  2. &ResourceId=s-946ntx4wr
  3. &ResourceType=snapshot
  4. &RegionId=cn-shenzhen
  5. &Tag.1.Key=test
  6. &Tag.1.Value=api
  7. &<公共请求参数>

返回示例

XML 格式

  1. <AddTagsResponse>
  2. <RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
  3. </AddTagsResponse>

JSON 格式

  1. {
  2. "RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0"
  3. }
本文导读目录