# API Gateway 中适用于 REST API 且无映射模板的有效载荷的方法请求行为
<a name="integration-passthrough-behaviors"></a>

如果方法请求有一个有效载荷，而您没有为 `Content-Type` 标头定义映射模板，则可以选择通过集成请求将客户端提供的请求有效载荷传递到后端，而不进行转换。此过程称为集成传递。

 传入请求的实际传递行为由此设置决定。这里有三个选项：

**当没有模板与请求的 Content-Type 标头匹配时**  
如果您希望在方法请求内容类型不匹配任何与映射模板关联的内容类型时，将方法请求正文通过集成请求发送到后端而不进行转换，则选择此选项。  
调用 API Gateway API 时，您通过将 `WHEN_NO_MATCH` 设置为[集成](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html)的 `passthroughBehavior` 属性值来选择此选项。

**未定义任何模板时（推荐）**  
如果您希望在集成请求中未定义映射模板时，将方法请求正文通过集成请求发送到后端而不进行转换，则选择此选项。如果在选择此选项时定义了模板，则具有与任何定义的映射模板都不匹配的有效载荷和内容类型的方法请求将遭到拒绝，并返回“HTTP 415 媒体类型不受支持”响应。  
调用 API Gateway API 时，您通过将 `WHEN_NO_TEMPLATES` 设置为[集成](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html)的 `passthroughBehavior` 属性值来选择此选项。

**从不**  
如果您不希望在集成请求中未定义映射模板时，将方法请求正文通过集成请求发送到后端而不进行转换，则选择此选项。如果选择此选项时定义了模板，则会以“HTTP 415 Unsupported Media Type”响应拒绝未映射内容类型的方法请求。  
调用 API Gateway API 时，您通过将 `NEVER` 设置为[集成](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html)的 `passthroughBehavior` 属性值来选择此选项。

 以下示例显示了可能的传递行为。

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


| Content-type | 传递选项 | 行为 | 
| --- | --- | --- | 
| 无 API Gateway 默认为 `application/json` | WHEN\$1NO\$1MATCH | 使用模板转换请求负载。 | 
| 无 API Gateway 默认为 `application/json` | WHEN\$1NO\$1TEMPLATES | 使用模板转换请求负载。 | 
| 无 API Gateway 默认为 `application/json` | NEVER | 使用模板转换请求负载。 | 
| application/json | WHEN\$1NO\$1MATCH | 使用模板转换请求负载。 | 
| application/json | WHEN\$1NO\$1TEMPLATES | 使用模板转换请求负载。 | 
| application/json | NEVER | 使用模板转换请求负载。 | 
| application/xml | WHEN\$1NO\$1MATCH | 请求负载未转换，并按原样发送到后端。 | 
| application/xml | WHEN\$1NO\$1TEMPLATES | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 
| application/xml | NEVER | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 

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


| Content-type | 传递选项 | 行为 | 
| --- | --- | --- | 
| 无 API Gateway 默认为 `application/json` | WHEN\$1NO\$1MATCH | 请求负载未转换，并按原样发送到后端。 | 
| 无 API Gateway 默认为 `application/json` | WHEN\$1NO\$1TEMPLATES | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 
| 无 API Gateway 默认为 `application/json` | NEVER | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 
| application/json | WHEN\$1NO\$1MATCH | 请求负载未转换，并按原样发送到后端。 | 
| application/json | WHEN\$1NO\$1TEMPLATES | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 
| application/json | NEVER | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 
| application/xml | WHEN\$1NO\$1MATCH | 使用模板转换请求负载。 | 
| application/xml | WHEN\$1NO\$1TEMPLATES | 使用模板转换请求负载。 | 
| application/xml | NEVER | 使用模板转换请求负载。 | 

示例 3：集成请求中未定义映射模板。


| Content-type | 传递选项 | 行为 | 
| --- | --- | --- | 
| 无 API Gateway 默认为 `application/json` | WHEN\$1NO\$1MATCH | 请求负载未转换，并按原样发送到后端。 | 
| 无 API Gateway 默认为 `application/json` | WHEN\$1NO\$1TEMPLATES | 请求负载未转换，并按原样发送到后端。 | 
| 无 API Gateway 默认为 `application/json` | NEVER | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 
| application/json | WHEN\$1NO\$1MATCH | 请求负载未转换，并按原样发送到后端。 | 
| application/json | WHEN\$1NO\$1TEMPLATES | 请求负载未转换，并按原样发送到后端。 | 
| application/json | NEVER | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 | 
| application/xml | WHEN\$1NO\$1MATCH | 请求负载未转换，并按原样发送到后端。 | 
| application/xml | WHEN\$1NO\$1TEMPLATES | 请求负载未转换，并按原样发送到后端。 | 
| application/xml | NEVER | 请求被拒绝，得到 HTTP 415 Unsupported Media Type 响应。 |