AWS CLI 使用 Application Signals untag-resource 删除 SLO 资源标签的完整指南【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli本文为 AWS CLIaws-cli中application-signals服务的untag-resource子命令技术指南覆盖命令语法、必填参数取值规则、ARN 格式说明、无输出的行为约定以及与之配套的tag-resource/list-tags-for-resource标签管理闭环读完后你可以基于 aws-cli 仓库内置的 API 模型service-2.json确认参数约束与错误码独立完成 CloudWatch Application Signals 服务下 SLOService Level Objective资源的标签删除操作。1. 命令作用与原始示例untag-resource用于从指定的 CloudWatch Application Signals 资源典型场景是 SLO上删除一个或多个标签。aws-cli 仓库中的官方示例文件 untag-resource.rst 给出的完整调用如下aws application-signals untag-resource \ --resource-arn arn:aws:application-signals:us-east-1:123456789101:slo/SLOName \ --tag-keys test示例说明--resource-arn指定目标资源的 ARN。示例中使用的格式为arn:aws:application-signals:region:account-id:slo/slo-name其中示例值us-east-1、123456789101、SLOName均为占位内容实际执行时请替换为你自己账号中 SLO 的真实 ARN--tag-keys是要移除的标签键test即删除键为test的标签连同其对应的值一起移除原文档明确指出该命令执行成功后不产生任何输出。因此判断执行结果主要依据退出码与终端是否有错误信息而不是解析返回体。该示例对应的 AWS 文档主题是 CloudWatch 用户指南中的 Application Signals 部分aws-cli 仅作为其命令行入口。2. 参数规格来自 API 模型文件的权威依据aws application-signals在 aws-cli 仓库中没有单独的定制 Python 模块customizations 目录下无对应条目其命令行参数完全由 botocore 内置的 API 模型驱动。Application Signals 的模型文件位于 service-2.jsonAPI 版本2024-04-15serviceId 为Application Signals其中对UntagResource操作及其请求形状shape的定义给出了精确的参数约束2.1 请求结构UntagResourceRequest参数CLI 名称类型必填约束说明ResourceArn--resource-arnstringAmazonResourceName是长度 1–1024 字符要删除标签的 CloudWatch 资源 ARNTagKeys--tag-keyslist of stringTagKeyList是列表元素最多 200 个单个键长 1–128 字符要从资源上移除的标签键列表要点解读两个参数缺一不可。模型中required字段为[ResourceArn, TagKeys]缺少任一项时 CLI 会在本地参数校验阶段直接报错不会发出 HTTP 请求--tag-keys本质是列表。虽然原始示例只传了一个值test但从源码结构看它接受多个标签键——一次调用即可批量删除例如aws application-signals untag-resource \ --resource-arn arn:aws:application-signals:us-east-1:123456789101:slo/SLOName \ --tag-keys test owner team-abc在 aws-cli 中列表参数既可以按上例以空格分隔逐项传入也可以使用 JSON 列表形式--tag-keys [test,owner]传递删除按“键”匹配API 只接受标签键TagKeyList的元素形状是TagKey而非键值对结构即按 key 整体移除不支持指定 value 过滤ARN 格式补充模型文件中ResourceArn的文档同时给出了 Application Signals SLO 的 ARN 形式arn:aws:cloudwatch:Region:account-id:slo:slo-name。可以看到官方文档示例arn:aws:application-signals:...与模型文档arn:aws:cloudwatch:...存在前缀差异实际使用中请以get-service-level-objective等命令返回的真实 ARN 为准避免手拼出错空列表的语义TagKeyList的min为 0模型层面允许空列表但没有任何键可删的调用没有实际意义建议始终至少传入一个真实存在的标签键。2.2 底层 HTTP 调用从同一模型文件看UntagResource的传输层定义为方法POST请求路径/untag-resource成功响应码200响应体UntagResourceResponse的成员为空结构members: {}这与原始示例“该命令不产生输出”的描述完全一致——即使成功服务端也几乎不返回可用数据CLI 端不会打印 JSON。3. 可能遇到的错误及处理模型为UntagResource声明了两个显式错误类型对应 service-2.json 中errors数组错误HTTP 状态码是否客户端责任含义与排查ResourceNotFoundException404是senderFaultARN 拼写错误或 SLO 不存在/已被删除。错误体包含ResourceType、ResourceId、Message三个必填字段可据此定位是资源类型不识别还是 ID 找不到ThrottlingException429是请求因配额限制被限流。建议稍后重试批量清理标签脚本中应加入退避backoff处理aws-cli/botocore 自身的重试机制对该类 429 的处理以全局--retries配置为准实用排查流程先执行只读命令确认资源与标签现状见下节list-tags-for-resource核对 ARN 与标签键拼写再执行untag-resource无输出即成功若返回 404用list-service-level-objectives确认 SLO 名称是否准确。4. 标签管理闭环tag → list → untaguntag-resource很少孤立使用。aws-cli 仓库的同一示例目录下提供了完整的标签管理配套示例三者构成“打标签—查标签—删标签”的闭环4.1 添加标签tag-resource来自 tag-resource.rstaws application-signals tag-resource \ --resource-arn arn:aws:application-signals:us-east-1:123456789101:slo/SLOName \ --tags {Key:test,Value:value}行为规则来自模型文件TagResource操作文档对一个已带标签的资源再次调用新键追加到标签集合相同键的新值会覆盖旧值单资源最多关联50 个标签标签对 AWS 无语义含义严格按字符串处理--tags传入键值对 JSON标签值长度上限 256 字符TagValue形状标签键上限 128 字符该命令同样不产生输出。4.2 查询标签list-tags-for-resource来自 list-tags-for-resource.rstaws application-signals list-tags-for-resource \ --resource-arn arn:aws:application-signals:us-east-1:123456789101:slo/SLOName返回示例{ Tags: [{ Key: test, Value: value }] }该操作在模型中标记为readonly: true底层为GET /tags是执行删除前确认键名、删除后验证结果的唯一可靠手段。4.3 推荐的完整操作序列# 1) 确认当前标签 aws application-signals list-tags-for-resource \ --resource-arn arn:aws:application-signals:us-east-1:123456789101:slo/SLOName # 2) 删除指定标签键可一次传多个键 aws application-signals untag-resource \ --resource-arn arn:aws:application-signals:us-east-1:123456789101:slo/SLOName \ --tag-keys test owner # 3) 复核结果 aws application-signals list-tags-for-resource \ --resource-arn arn:aws:application-signals:us-east-1:123456789101:slo/SLOName5. 注意事项与适用前提适用版本本仓库内置的 Application Signals API 模型版本为2024-04-15见 2024-04-15 目录参数名与行为以该模型为准无输出即成功由于UntagResourceResponse为空结构不要期望看到类似 S3 删除对象的确认输出脚本中应以命令退出码判断成败权限要求调用者需要对该服务具备UntagResource的 IAM 权限标签也是 CloudWatch 中按资源缩小授权范围的常用手段模型文档明确提到可用标签值限定用户权限只按键删除--tag-keys只接受标签键列表无法表达“仅当值为某值时才删除”的条件语义区域与账号ARN 中必须包含正确的 region 与 account-id跨区域误用 ARN 是最常见的 404 来源。6. 参考文件索引文件说明untag-resource.rst本文核心untag-resource 官方命令行示例tag-resource.rst配套的打标签示例list-tags-for-resource.rst配套的标签查询示例与返回结构service-2.jsonApplication Signals API 模型2024-04-15含参数约束、HTTP 定义与错误类型【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考