aws-cli 中 Application Auto Scaling 的 tag-resource 命令实战为可伸缩目标打标签【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli本文基于 aws-cli 仓库中的示例文档 tag-resource.rst 展开讲解aws application-autoscaling tag-resource命令的完整用法如何为 Application Auto Scaling 的可伸缩目标scalable target添加或编辑标签、ARN 与标签的取值约束、命令为何不产生输出以及如何配合list-tags-for-resource、untag-resource完成标签的全生命周期管理。读完本文你可以直接复制命令在自己的环境中标记可伸缩目标并理解每个参数背后的服务模型约束。tag-resource 的功能定位tag-resource对应服务模型中的TagResourceAPI 操作其官方文档说明见 service-2.json 中TagResource条目的 documentation 字段为Adds or edits tags on an Application Auto Scaling scalable target.即向可伸缩目标添加新标签或编辑已有标签的值。由此可以得到几个关键结论可打标签的对象只有可伸缩目标本身。服务模型明确指出不能对缩放策略scaling policy或计划动作scheduled action打标签只能对 scalable target 打标签。同一 key 不允许重复。模型中Tags字段TagMap形状的文档说明同一个可伸缩目标上不能有多个相同 key 的标签如果指定了已存在的 key 且 value 不同Application Auto Scaling 会用新值替换旧值——这就是adds or edits中edits的实现语义。打标签还有另一个入口在注册可伸缩目标时RegisterScalableTarget也可以同时指定标签tag-resource适合事后补充或修正标签的场景。标签的实际用途之一是访问控制官方文档建议用标签来控制对可伸缩目标的访问权限这也是为自动伸缩资源建立计费分账、环境隔离标签的主要 CLI 手段。命令示例为可伸缩目标添加标签示例文档给出的完整命令如下原样保留可直接复制修改aws application-autoscaling tag-resource \ --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \ --tags environmentproduction该命令的作用向指定 ARN 的可伸缩目标添加 key 为environment、value 为production的标签。参数详解结合服务模型中TagResourceRequest的定义service-2.json#L1777-L1797两个参数均为必填参数必填对应模型字段说明--resource-arn是ResourceARN形状AmazonResourceName指定要应用标签的可伸缩目标的 ARN。ARN 的获取方式调用DescribeScalableTargets--tags是Tags形状TagMap要分配的标签集合采用keyvalue的 shorthand 语法同一 key 重复时执行值替换--tags的keyvalue书写方式由 CLI 层的 shorthand 语法解析实现见 shorthand.py。一次可以传多个标签例如--tags environmentproduction teamplatform cost-center12345ARN 格式的硬性约束AmazonResourceName形状在服务模型中定义了正则约束service-2.json#L270-L275^arn:.:application-autoscaling:.:[0-9]:scalable-target/[a-zA-Z0-9-]$长度范围最小 1、最大 1011 个字符必须形如arn:partition:application-autoscaling:region:account-id:scalable-target/资源ID其中资源 ID 只能包含字母、数字和连字符示例文档中的 ARNarn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/...完全符合该模式。因此如果误传了其他服务如 EC2 Auto Scaling group的 ARN请求会在服务端被以ValidationException拒绝。标签 key / value 的长度限制从服务模型的两个基础形状可以看出取值边界service-2.json#L1761-L1776形状长度范围对应 CLI 概念TagKey1 ~ 128 字符不允许空 key标签键TagValue0 ~ 256 字符允许空 value标签值TagKeyList0 ~ 200 个元素untag-resource的--tag-keys列表标签的 key 和 value 都是大小写敏感的字符串Environment与environment是两个不同的 key。执行结果为什么没有输出示例文档明确写道This command produces no output.这一点在服务模型中有直接依据——TagResourceResponse形状的成员为空service-2.json#L1794-L1797TagResourceResponse: { type: structure, members: {} }也就是说操作成功时 HTTP 响应体中没有可供 CLI 序列化的字段CLI 不会打印任何 JSON。判断命令是否成功要看退出码0 表示成功而不是标准输出。可能遇到的错误服务模型为TagResource操作声明了三个异常service-2.json#L217-L221异常含义常见触发原因ResourceNotFoundException资源不存在ARN 拼写错误、目标已注销deregisterTooManyTagsException标签数量超限单个可伸缩目标上的标签总数超过服务配额ValidationException参数校验失败ARN 不符合上述正则、key/value 超长或包含非法字符其中TooManyTagsException的模型文档说明service-2.json#L1963-L1969为The request contains too many tags. Try the request again with fewer tags.提示应按账号级的 Application Auto Scaling 服务配额来收敛标签数量。配套命令查询与删除标签tag-resource不是孤立操作。同一个示例目录中提供了两个配套示例共同构成标签管理闭环用 list-tags-for-resource 验证标签已生效见 list-tags-for-resource.rstaws application-autoscaling list-tags-for-resource \ --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123由于TagResource本身无输出这是确认标签写入成功的标准做法。其返回结构由ListTagsForResourceResponse定义service-2.json#L701-L709示例文档给出的实际输出为{ Tags: { environment: production } }Tags是TagMap类型以 key 为键、value 为值的映射注意它与--tags的keyvalue列表写法不同——输出是 JSON 对象输入是 shorthand 键值对。用 untag-resource 删除标签见 untag-resource.rstaws application-autoscaling untag-resource \ --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \ --tag-keys environment模型中UntagResourceRequest要求ResourceARN与TagKeys两个必填字段service-2.json#L1970-L1986且文档强调Specify only the tag keys, not the tag values——删除时只需给出 key无需也不能给出 value可一次传多个 key。如何拿到 ARNResourceARN字段的模型文档service-2.json#L1784-L1786给出的官方建议是调用DescribeScalableTargets获取可伸缩目标的 ARN。典型工作流是# 1. 查询已注册的可伸缩目标从中复制 ScalableTargetARN aws application-autoscaling describe-scalable-targets \ --service-namespace dynamodb # 2. 为拿到的 ARN 打标签 aws application-autoscaling tag-resource \ --resource-arn 上一步复制的ARN \ --tags environmentproduction # 3. 验证 aws application-autoscaling list-tags-for-resource \ --resource-arn 同一ARN小结与实践要点tag-resource的两个参数--resource-arn和--tags均为必填ARN 必须符合scalable-target专属格式命令成功时没有任何输出以退出码判断成败用list-tags-for-resource确认结果相同 key 再次调用tag-resource是覆盖更新而非报错key 大小写敏感key 最长 128 字符、value 最长 256 字符标签只能打在可伸缩目标上不能打在缩放策略或计划动作上若目标较多注意TooManyTagsException对应的服务配额限制删除标签用untag-resource --tag-keys只需 key 不需要 value。更多标签相关的官方背景本文示例文档的参考一节所指向的内容可在 Application Auto Scaling User Guide 的 Tagging support for Application Auto Scaling 章节查阅服务级别的完整行为约束以仓库内的 service-2.json 模型文件为准。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考