AWS CLIapigatewayv2 delete-routing-rule实战指南删除 API Gateway 自定义域名的路由规则【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-clidelete-routing-rule是 AWS CLI 中 API Gateway v2apigatewayv2服务提供的命令用于删除自定义域名custom domain name下与 REST API 阶段绑定的路由规则routing rule。本文以仓库内 delete-routing-rule.rst 示例文档为主线结合同目录下 create / put / get / list 路由规则示例以及 service-2.json 服务模型讲解该命令的参数、底层 HTTP 行为、错误场景以及完整的使用闭环。读完本文你将掌握如何在 AWS CLI 中安全地查询、更新与删除路由规则并理解其在自定义域名多 API 路由场景中的作用。一、路由规则是什么为什么需要删除它在 API Gateway v2 中路由规则用于把自定义域名下的请求路径base path映射到某个具体 API 的某个 Stage。借助路由规则你可以在一个自定义域名例如regional.example.com下挂载多个 REST API并通过MatchBasePaths条件按路径前缀把流量分发到不同的 API。从仓库中的 create-routing-rule.rst 可以看出一条路由规则的核心元素包括Conditions匹配条件例如MatchBasePaths的AnyOf列表指定了要匹配的路径前缀如PetStoreShopperActions匹配后执行的动作例如InvokeApi指向目标 APIApiId及其StagePriority规则的优先级数值越小优先级越高RoutingRuleId/RoutingRuleArn规则的唯一标识与 ARN。当某条规则不再需要例如对应 API 已下线、路径前缀调整、或希望把该路径恢复为默认 API 处理时就需要使用delete-routing-rule将其删除。二、命令语法与参数详解示例文档给出了最精简的删除调用方式aws apigatewayv2 delete-routing-rule \ --domain-name regional.example.com \ --routing-rule-id aaa111对照 service-2.json 中DeleteRoutingRuleRequest的模型定义该命令支持以下参数参数类型必填位置说明--domain-namestring是URI 路径参数domainName要删除路由规则所属的自定义域名如regional.example.com--routing-rule-idstring是URI 路径参数routingRuleId待删除的路由规则 ID如aaa111--domain-name-idstring否查询字符串参数domainNameId自定义域名的 ID用于精确定位域名资源其中DomainName与RoutingRuleId均为required必填字段缺少任何一个都会导致请求参数校验失败。如何获取--routing-rule-id路由规则 ID 并非手工编造而是由 API Gateway 在创建规则时生成示例中的aaa111为演示用的简化 ID。你可以通过 list-routing-rules.rst 中演示的list-routing-rules命令按域名列出全部规则及其 IDaws apigatewayv2 list-routing-rules \ --domain-name regional.example.com返回的RoutingRules数组中每一项都包含RoutingRuleId、RoutingRuleArn、Priority、Conditions、Actions等字段在删除前也可以用 get-routing-rule.rst 中的get-routing-rule命令确认单条规则的现状aws apigatewayv2 get-routing-rule \ --domain-name regional.example.com \ --routing-rule-id aaa111三、执行结果与底层 HTTP 行为示例文档明确指出This command produces no output.即删除成功后命令不打印任何内容。这一点与底层 API 定义完全吻合在 service-2.json 中DeleteRoutingRule操作对应的 HTTP 定义为MethodDELETERequest URI/v2/domainnames/{domainName}/routingrules/{routingRuleId}Response Code204No Content204 响应本身就代表操作成功但无响应体因此 AWS CLI 会静默返回、不输出任何 JSON。判断删除是否成功的方式是命令以退出码 0 结束且无错误输出即为成功若要进一步验证可再次调用get-routing-rule或list-routing-rules确认该规则已从列表中消失此时通常会收到NotFoundException错误。四、错误场景与排查根据服务模型DeleteRoutingRule可能返回以下异常这些异常会以 AWS CLI 错误信息的形式呈现异常含义常见触发原因NotFoundException请求的资源不存在--domain-name或--routing-rule-id拼写错误、规则已被删除或属于其他域名BadRequestException请求参数无效参数格式错误、缺少必填参数、域名格式不合法TooManyRequestsException请求超过限流阈值短时间内发送过多 API 请求触发 API Gateway 限流排查建议先用list-routing-rules核对域名下实际存在的RoutingRuleId避免输入过期的 ID确认--domain-name与规则创建时使用的域名完全一致区分大小写与尾点若命中TooManyRequestsException适当退避重试避免高频连续调用。另外模型中将该操作标记为idempotent: true即重复执行删除不会产生副作用——对同一个已经不存在的规则再次删除返回的仍是资源不存在类错误而不会对现有规则造成意外影响。五、完整使用闭环创建 → 查询 → 更新 → 删除为帮助你把delete-routing-rule放入真实工作流下面给出配套的同系列命令对照需求命令参考示例创建路由规则含条件与动作aws apigatewayv2 create-routing-rule --domain-name ... --priority ... --conditions ... --actions ...create-routing-rule.rst查询单条规则aws apigatewayv2 get-routing-rule --domain-name ... --routing-rule-id ...get-routing-rule.rst列出域名下全部规则aws apigatewayv2 list-routing-rules --domain-name ...list-routing-rules.rst更新规则如调整优先级aws apigatewayv2 put-routing-rule --routing-rule-id ... --domain-name ... --priority ... --conditions ... --actions ...put-routing-rule.rst删除规则aws apigatewayv2 delete-routing-rule --domain-name ... --routing-rule-id ...delete-routing-rule.rst一个典型的规则下线流程如下# 1. 确认待删除规则结合 jq 筛选指定规则 aws apigatewayv2 list-routing-rules \ --domain-name regional.example.com # 2. 删除规则无输出即成功 aws apigatewayv2 delete-routing-rule \ --domain-name regional.example.com \ --routing-rule-id aaa111 # 3. 复核规则已移除预期返回 NotFoundException 或列表不再包含该 ID aws apigatewayv2 get-routing-rule \ --domain-name regional.example.com \ --routing-rule-id aaa111注意上述命令中的域名与 ID 均为示例占位值请替换为你账号下真实的自定义域名与路由规则 ID。apigatewayv2命令的具体可用版本以当前仓库对应的 AWS CLI 版本为准。六、源码依据小结本文所有结论均可在仓库内直接验证命令示例与无输出行为见 delete-routing-rule.rst规则结构与输出字段Actions、Conditions、Priority、RoutingRuleArn、RoutingRuleId见 create-routing-rule.rst、put-routing-rule.rst、get-routing-rule.rst、list-routing-rules.rstHTTP 方法、URI、204 响应码、异常与幂等标记见 service-2.json 及DeleteRoutingRuleRequest定义同文件 L6558-L6584分页结果键RoutingRules见 paginators-1.json。掌握delete-routing-rule之后配合create/put/get/list四个命令你就能完整地管理自定义域名下的路由规则生命周期实现按路径前缀灵活调度多个 REST API 的目标。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考