# x-amazon-apigateway-gateway-responses.gatewayResponse 객체
<a name="api-gateway-swagger-extensions-gateway-responses.gatewayResponse"></a>

상태 코드, 적용 가능한 응답 파라미터 또는 응답 템플릿을 포함하여 지정된 응답 유형의 게이트웨이 응답을 정의합니다.


| 속성 이름 | 유형 | 설명 | 
| --- | --- | --- | 
| responseParameters | [x-amazon-apigateway-gateway-responses.responseParameters](api-gateway-swagger-extensions-gateway-responses.responseParameters.md) |  [GatewayResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_GatewayResponse.html) 파라미터, 즉 헤더 파라미터를 지정합니다. 파라미터 값은 수신되는 [요청 파라미터](rest-api-parameter-mapping.md) 값 또는 정적 사용자 지정 값을 가질 수 있습니다.  | 
| responseTemplates | [x-amazon-apigateway-gateway-responses.responseTemplates](api-gateway-swagger-extensions-gateway-responses.responseTemplates.md) |  게이트웨이 응답의 매핑 템플릿을 지정합니다. 템플릿은 VTL 엔진에 의해 처리되지 않습니다.  | 
| statusCode | string |  게이트웨이 응답에 대한 HTTP 상태 코드입니다.  | 

## x-amazon-apigateway-gateway-responses.gatewayResponse 예제
<a name="api-gateway-swagger-extensions-gateway-responses.gatewayResponse-example"></a>

 다음과 같은 OpenAPI에 대한 API Gateway 확장 예제에서는 [GatewayResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_GatewayResponse.html)를 정의하여 `INVALID_API_KEY`의 상태 코드, 수신 요청의 `456` 헤더 값 및 `api-key` 메시지를 반환하도록 `"Bad api-key"` 응답을 사용자 지정합니다.

```
    "INVALID_API_KEY": {
      "statusCode": "456",
      "responseParameters": {
        "gatewayresponse.header.api-key": "method.request.header.api-key"
      },
      "responseTemplates": {
        "application/json": "{\"message\": \"Bad api-key\" }"
      }
    }
```