针对 API Gateway 中的 REST API 的请求验证 - Amazon API Gateway
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

针对 API Gateway 中的 REST API 的请求验证

您可以配置 API Gateway,使其在处理集成请求之前对 API 请求执行基本验证。如果验证失败,API Gateway 会立即取消请求、向调用方返回 400 错误响应,并在 CloudWatch Logs 中发布验证结果。这可以减少对后端进行的不必要调用。更重要的是,它可以让您把精力集中在特定于应用程序的验证工作上。您可以通过验证所需请求参数是否有效并且不为空,或为更复杂的数据验证指定一个模型架构,从而验证请求正文。

API Gateway 中的基本请求验证概览

API Gateway 可以执行基本请求验证,以便您可以专注于后端的应用程序特定验证。进行验证时,API Gateway 验证以下一项或两项条件:

  • 传入请求的 URI、查询字符串和标头中带有所需的请求参数且都不为空。

  • 适用的请求负载符合相关方法的所配置的 JSON 架构请求。

要开启验证,您需要在请求验证程序中指定验证规则,将验证程序添加到 API 的请求验证程序的映射中,并将验证程序分配给各个 API 方法。

注意

请求正文验证和集成传递行为是两个独立的主题。当请求负载没有匹配的模型架构时,可以选择传递或阻止原始负载。有关更多信息,请参阅 集成传递行为