开发者社区 问答 正文

API参考 - API参考 -  标签管理 - AddTagsToResource



描述


为实例绑定已有的或新创建的标签,限制如下:


  • 每个标签(Tag)由标签键(TagKey)和标签值(TagValue)组成,TagKey不能为空,TagValue可以为空。

  • TagKey和TagValue的值不允许以aliyun开头。

  • TagKey和TagValue不区分大小写。

  • TagKey最长为64个字符,TagValue最长为128个字符。

  • 每个实例最多绑定10个Tag,且每个实例绑定的TagKey不能重复。若绑定带有重复TagKey的Tag,则最后绑定的Tag将覆盖已绑定的Tag。


请求参数

名称类型是否必须描述
ActionString系统规定参数,取值为AddTagsToResource。
RegionIdString地域,例如cn-hangzhou。
DBInstanceIdString
  • 实例ID,支持传入多个实例Id进行批量操作,最多传入30个;
  • 格式示例:instance1,instance2,instance3。
TagsJson String
  • 需要绑定的Tag列表,包括TagKey和TagValue;
  • 单次最多支持传入5组值;
  • TagKey不能为空,TagValue可以为空。
  • 格式示例:{“key1”:”value1”,“key2”:””}。


返回参数

[tr=rgb(51, 205, 229)]名称类型描述[tr=rgb(239, 251, 255)]<公共返回参数>无详见 公共参数

展开
收起
梨好橙 2018-09-16 22:53:05 1523 分享 版权
阿里云 AI 助理回答

为实例绑定标签的操作允许您将已有的或新创建的标签附加到指定的实例上,以便于资源的分类、管理和过滤。以下是操作时需遵循的具体限制和请求参数详情:

限制条件

  • 标签组成:每个标签由**标签键(TagKey)标签值(TagValue)**构成,其中TagKey是必填项,而TagValue可选为空。
  • 命名规则:TagKey与TagValue的值均不允许以aliyun开头,且不区分大小写。
  • 字符限制:TagKey长度最大为64个字符;TagValue长度最大为128个字符。
  • 数量限制:每个实例最多能绑定10个不同的Tag,并且对于同一实例,不能有重复的TagKey。如果尝试绑定具有相同TagKey的新标签,这将覆盖原有的同名TagKey对应的TagValue。

请求参数说明

  • Action:系统预设参数,固定值为AddTagsToResource,表示执行添加标签的操作。
  • RegionId:必需,指定操作所在的地域ID,例如cn-hangzhou
  • DBInstanceId:必需,实例ID列表,支持批量操作,最多可传入30个实例ID,用英文逗号分隔,如instance1,instance2,instance3
  • Tags:必需,需要绑定的标签列表,格式为JSON字符串,包含多组TagKey和TagValue。单次请求最多支持5组,示例:{"key1":"value1","key2":""}。注意,TagKey不能为空,TagValue可以为空。

返回参数

返回参数信息未直接提供,但根据参考资料提示,请参考相关API文档中的公共参数部分,这些通常包括请求ID、错误码、错误信息等标准响应内容。

通过调用此接口并遵循上述规范,您可以有效地管理实例上的标签,提升资源管理的效率和精确度。

请注意,实际操作时应确保遵守阿里云平台的最新API使用规定和最佳实践。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答