# x-amazon-apigateway-integration.response 对象
<a name="api-gateway-swagger-extensions-integration-response"></a>

 定义响应并指定从集成响应到方法响应的参数映射或负载映射。


| 属性名称 | 类型 | 说明 | 
| --- | --- | --- | 
| statusCode | string |  方法响应的 HTTP 状态代码，例如 `"200"`。必须对应 [OpenAPI 操作](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md#operation-object)`responses`字段中的匹配响应。  | 
| responseTemplates | [x-amazon-apigateway-integration.responseTemplates 对象](api-gateway-swagger-extensions-integration-responseTemplates.md) |  为响应的负载指定特定于 MIME 类型的映射模板。  | 
| responseParameters | [x-amazon-apigateway-integration.responseParameters 对象](api-gateway-swagger-extensions-integration-responseParameters.md) |  指定响应的参数映射。仅集成响应的 `header` 和 `body` 参数可以映射到方法的 `header` 参数。  | 
| contentHandling | string | 响应负载编码转换类型。有效值为 1) CONVERT\$1TO\$1TEXT，用于将二进制负载转换为 Base64 编码字符串，或者将文本负载转换为 utf-8 编码字符串，或者在无任何修改的情况下直接传递文本负载，以及 2) CONVERT\$1TO\$1BINARY，用于将文本负载转换为 Base64 解码的二进制大型对象，或者在无任何修改的情况下直接传递二进制负载。 | 

## `x-amazon-apigateway-integration.response` 示例
<a name="api-gateway-swagger-extensions-response-example"></a>

下面的示例为从后端获得 `302` 或 `application/json` MIME 类型负载的方法定义了 `application/xml` 响应。该响应使用提供的映射模板，从方法的 `Location` 标头中的集成响应中返回重定向 URL。

```
{
    "statusCode" : "302",
    "responseTemplates" : {
         "application/json" : "#set ($root=$input.path('$')) { \"stage\": \"$root.name\", \"user-id\": \"$root.key\" }",
         "application/xml" : "#set ($root=$input.path('$')) <stage>$root.name</stage> "
    },
    "responseParameters" : {
        "method.response.header.Location": "integration.response.body.redirect.url"
    }
}
```