Amazon API Gateway
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

集成传递行为

如果没有代理集成,当方法请求携带负载,并且 Content-Type 标头不匹配任何指定的映射模板或未定义任何映射模板时,您可以选择将客户端提供的请求负载通过集成请求传递到后端而不进行转换。此过程称为集成传递。

对于代理集成,API Gateway 会将整个请求传递到后端,并且您不能修改传递行为。

传入请求的实际传递行为由您在集成请求设置期间为指定映射模板选择的选项以及客户端在传入请求中设置的 Content Type 标头确定。以下示例说明了可能的传递行为。

示例 1:application/json 内容类型的集成请求中定义了一个映射模板。

Content-Type 标头\选定的传递选项 WHEN_NO_MATCH WHEN_NO_TEMPLATE NEVER
无 (默认为 application/json) 使用模板转换请求负载。 使用模板转换请求负载。 使用模板转换请求负载。
application/json 使用模板转换请求负载。 使用模板转换请求负载。 使用模板转换请求负载。
application/xml 请求负载未转换,并按原样发送到后端。 请求被拒绝,得到 HTTP 415 Unsupported Media Type 响应。 请求被拒绝,得到 HTTP 415 Unsupported Media Type 响应。

示例 2:application/xml 内容类型的集成请求中定义了一个映射模板。

Content-Type 标头\选定的传递选项 WHEN_NO_MATCH WHEN_NO_TEMPLATE NEVER
无 (默认为 application/json) 请求负载未转换,并按原样发送到后端。 请求被拒绝,得到 HTTP 415 Unsupported Media Type 响应。 请求被拒绝,得到 HTTP 415 Unsupported Media Type 响应。
application/json 请求负载未转换,并按原样发送到后端。 请求被拒绝,得到 HTTP 415 Unsupported Media Type 响应。 请求被拒绝,得到 HTTP 415 Unsupported Media Type 响应。
application/xml 使用模板转换请求负载。 使用模板转换请求负载。 使用模板转换请求负载。