AWS CLI 中 delete-service-level-objective 命令详解删除 CloudWatch Application Signals 的 SLO【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli本文围绕 AWS CLIaws-cli仓库中的示例文档 delete-service-level-objective.rst 展开讲解如何使用aws application-signals delete-service-level-objective命令删除 CloudWatch Application Signals 中的服务等级目标SLOService Level Objective。读完本文你能掌握该命令的唯一参数--id的取值规范ARN 与资源名称、命令在服务端的实际 HTTP 行为DELETE 方法、幂等性、无响应体、可能遇到的三类错误以及它与同目录下 SLO 全生命周期管理命令之间的配套关系。1. 命令定位SLO 生命周期中的最后一步Amazon CloudWatch Application Signals 是 CloudWatch 的应用级可观测能力允许用户基于服务等级指标SLI创建 SLO用达成率目标attainment goal持续跟踪应用的可用性与时延表现。SLO 的完整生命周期在 AWS CLI 中对应一组同名的子命令示例文档统一组织在 awscli/examples/application-signals/ 目录下阶段命令对应示例文档创建create-service-level-objectivecreate-service-level-objective.rst查询get-service-level-objectiveget-service-level-objective.rst列表list-service-level-objectiveslist-service-level-objectives.rst更新update-service-level-objectiveupdate-service-level-objective.rst批量预算报告batch-get-service-level-objective-budget-reportbatch-get-service-level-objective-budget-report.rst删除delete-service-level-objectivedelete-service-level-objective.rst本文聚焦“删除”这一步。典型使用场景是SLO 对应的服务下线、指标配置需要重建、或者在自动化流程CI/CD 脚本、Terraform 式幂等清理中回收不再需要的 SLO 资源。2. 命令示例与完整参数说明原示例文档给出的命令如下aws application-signals delete-service-level-objective \ --id arn:aws:application-signals:us-east-1:123456789101:slo/SLOName该命令只接受一个参数--id文档明确指出“This command produces no output”命令不产生任何输出。结合仓库中随包内置的服务模型文件 service-2.json可以把参数说明补全如下参数是否必填类型说明--id是字符串要删除的 SLO 的 ARN 或名称。在服务模型中该字段位于 URI 路径location: urilocationName: Id即直接拼入请求路径关于--id的取值规范服务模型中定义了ServiceLevelObjectiveId形状其正则约束为[0-9A-Za-z][-._0-9A-Za-z ]{0,126}[0-9A-Za-z]$ | ^arn:(aws|aws-us-gov):application-signals:[^:]*:[^:]*:slo/[0-9A-Za-z][-._0-9A-Za-z ]{0,126}[0-9A-Za-z]也就是说--id可以传两种值SLO 名称首尾必须是字母或数字中间可含-、.、下划线和空格总长度不超过 128 字符SLO 的完整 ARN形如arn:aws:application-signals:us-east-1:123456789101:slo/SLOName其中SLOName部分同样受上述名称规则约束。模型中还允许aws-us-gov分区GovCloud的 ARN。ARN 的组成与 create-service-level-objective.rst 示例的输出保持一致——创建成功后返回的Slo.Arn字段即为删除时应传入的标识{ Slo: { Arn: arn:aws:application-signals:us-east-1:123456789101:slo/SLOName, Name: SLOName, Description: Description of your SLO, ... } }实践建议在脚本化删除场景中优先使用 ARN 而非名称。名称只在本账号、本区域内唯一而 ARN 携带了区域与账号信息可以避免跨区域误删同名 SLO模型文档也提示跨账号访问场景下 SLO 必须以 ARN 形式提供。3. 服务端 API 行为HTTP 方法、幂等性与空响应体CLI 命令并不是凭空生成的aws-cli 会把子命令映射到服务模型中定义的操作。在 service-2.json 中DeleteServiceLevelObjective操作的定义为HTTP 方法与路径DELETE /slo/{Id}成功响应码200。--id参数正是被替换进{Id}路径占位符这也是为什么它不需要出现在请求体中幂等性操作声明了idempotent: true。从源码结构看这意味着重复执行同一删除请求例如对已不存在的 SLO 再次发起删除在语义上是安全的适合用于清理脚本的幂等设计协议与签名整个 Application Signals 服务采用rest-json协议签名方式为aws.auth#sigv4签名名application-signals端点前缀为application-signals。因此执行该命令前必须配置好有效的凭证与区域例如通过aws configure或环境变量提供输入/输出形状DeleteServiceLevelObjectiveInput仅包含必填成员IdDeleteServiceLevelObjectiveOutput的成员为空结构。这与示例文档中“命令不产生任何输出”的说明完全吻合——成功时 CLI 不会打印 JSON脚本中可以通过检查退出码echo $?判断删除是否成功。4. 错误处理三类可能抛出的异常同一个服务模型文件列出了该操作可能返回的三类错误排障时可对照处理错误形状含义与常见触发原因ValidationException请求参数未通过校验。典型场景是--id既不是合法名称也不符合 ARN 正则例如名称以-开头、超过 128 字符ResourceNotFoundException指定区域与账号下不存在该 SLO或 ARN 中的区域/账号与实际不符ThrottlingException请求频率超过服务限额触发限流由于删除操作是破坏性的且没有“回收站”机制建议的稳妥流程是# 1. 先用 list 或 get 确认目标 SLO 存在及其 ARN aws application-signals list-service-level-objectives # 2. 执行删除 aws application-signals delete-service-level-objective \ --id arn:aws:application-signals:us-east-1:123456789101:slo/SLOName # 3. 用 get 验证删除结果预期返回 ResourceNotFoundException aws application-signals get-service-level-objective \ --id arn:aws:application-signals:us-east-1:123456789101:slo/SLOName5. 示例文档在 aws-cli 仓库中的组织方式理解这些示例文档的来源有助于快速定位同类内容。在 aws-cli 仓库中awscli/examples/service/目录存放各服务命令的 RST 格式用法示例application-signals下共有 15 个示例文件覆盖该服务的 SLO 管理、服务发现start-discovery、依赖关系list-service-dependencies/list-service-dependents、标签tag-resource/untag-resource/list-tags-for-resource等能力awscli/botocore/data/application-signals/2024-04-15/目录存放该服务 API 版本 2024-04-15 的服务模型service-2.json、分页器paginators-1.json与端点规则集endpoint-rule-set-1.jsonCLI 的帮助文本、参数校验和请求构造均由这些数据驱动生成示例文档末尾统一指向 Amazon CloudWatch User Guide 中的 Application Signals 章节原文使用超链接引用需要更完整的 SLO 概念如 error budget、period-based 与 request-based 两类 SLO 的评估方式时可结合 create-service-level-objective.rst 中携带的完整 SLO 结构示例对照阅读。6. 小结aws application-signals delete-service-level-objective是一个“参数极简、语义明确”的删除命令仅需通过--id传入 SLO 的 ARN 或名称成功时不产生输出服务端以DELETE /slo/{Id}处理且具备幂等特性。排障时重点关注ValidationExceptionID 格式非法、ResourceNotFoundException资源不存在与ThrottlingException限流三类错误即可。配合同目录下的 create/get/list/update 示例文档即可完成 Application Signals SLO 资源的完整命令行管理。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
