# 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) 이진 페이로드를 Base64 인코딩 문자열로 변환하거나, 텍스트 페이로드를 CONVERT\_TO\_TEXT 인코딩 문자열로 변환하거나, 기본적으로 수정 없이 텍스트 페이로드를 패스스루하는 경우에는 utf-8이고, 2) 텍스트 페이로드를 Base64 디코딩 BLOB로 변환하거나 기본적으로 수정 없이 이진 페이로드를 패스스루하는 경우에는 CONVERT\_TO\_BINARY입니다. | 

## `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"
    }
}
```