# API Gateway의 게이트웨이 응답 유형 API Gateway에서는 API 개발자가 사용자 지정할 수 있도록 다음과 같은 게이트웨이 응답을 공개합니다. | 게이트웨이 응답 유형 | 기본 상태 코드 | 설명 | | --- | --- | --- | | ACCESS\$1DENIED | 403 | 권한 부여 실패(예: 사용자 지정 또는 Amazon Cognito 권한 부여자가 액세스를 거부한 경우)에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | API\$1CONFIGURATION\$1ERROR | 500 | 유효하지 않은 엔드포인트 주소가 제출된 경우, 이진 지원이 수행될 때 이진 데이터에 대해 base64 디코딩이 실패한 경우, 통합 응답 매핑이 어떤 템플릿과도 일치할 수 없어서 기본 템플릿이 구성되어 있지 않은 경우를 포함하여 유효하지 않은 API 구성에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_5XX`입니다. | | AUTHORIZER\$1CONFIGURATION\$1ERROR | 500 | 사용자 지정 또는 Amazon Cognito 권한 부여자 연결 실패에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_5XX`입니다. | | AUTHORIZER\$1FAILURE | 500 | 사용자 지정 또는 Amazon Cognito 권한 부여자가 호출자를 인증하지 못한 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_5XX`입니다. | | BAD\$1REQUEST\$1PARAMETERS | 400 | 활성화된 요청 검사기에 따라 요청 파라미터를 확인할 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | BAD\$1REQUEST\$1BODY | 400 | 활성화된 요청 검사기에 따라 요청 본문을 확인할 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | DEFAULT\$14XX | Null | 상태 코드가 `4XX`인 지정되지 않은 응답 유형에 대한 기본 게이트웨이 응답입니다. 이 대체 게이트웨이 응답의 상태 코드를 변경하면 모든 다른 `4XX` 응답의 상태 코드가 새 값으로 변경됩니다. 이 상태 코드를 null로 재설정하면 모든 다른 `4XX` 응답의 상태 코드가 원래 값으로 되돌아갑니다. [AWS WAF 사용자 지정 응답](https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html)은 사용자 지정 게이트웨이 응답보다 우선합니다. | | DEFAULT\$15XX | Null | 상태 코드가 `5XX`인 지정되지 않은 응답 유형에 대한 기본 게이트웨이 응답입니다. 이 대체 게이트웨이 응답의 상태 코드를 변경하면 모든 다른 `5XX` 응답의 상태 코드가 새 값으로 변경됩니다. 이 상태 코드를 null로 재설정하면 모든 다른 `5XX` 응답의 상태 코드가 원래 값으로 되돌아갑니다. | | EXPIRED\$1TOKEN | 403 | AWS 인증 토큰 만료 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | INTEGRATION\$1FAILURE | 504 | 통합 실패 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_5XX`입니다. | | INTEGRATION\$1TIMEOUT | 504 | 통합 시간 초과 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_5XX`입니다. | | INVALID\$1API\$1KEY | 403 | API 키를 요구하는 메서드에 대해 제출되는 잘못된 API 키에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | INVALID\$1SIGNATURE | 403 | 잘못된 AWS 서명 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | MISSING\$1AUTHENTICATION\$1TOKEN | 403 | 클라이언트가 지원되지 않는 API 메서드 또는 리소스를 호출하려고 시도하는 경우를 비롯한 누락된 인증 토큰 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | QUOTA\$1EXCEEDED | 429 | 사용량 계획 할당량 초과 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | REQUEST\$1TOO\$1LARGE | 413 | 요청이 너무 큼 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본값은 `HTTP content length exceeded 10485760 bytes`입니다. | | RESOURCE\$1NOT\$1FOUND | 404 | API 키 인증 및 권한 부여를 제외하고 API 요청에서 인증 및 권한 부여를 전달한 이후에 API Gateway에서 지정된 리소스를 찾을 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | THROTTLED | 429 | 사용량 계획, 메서드, 단계 또는 계정 수준 조절 한도가 초과한 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | UNAUTHORIZED | 401 | 사용자 지정 또는 Amazon Cognito 권한 부여자가 호출자를 인증하지 못한 경우의 게이트웨이 응답입니다. | | UNSUPPORTED\$1MEDIA\$1TYPE | 415 | 엄격한 패스스루 동작을 활성화한 경우에 페이로드가 지원되지 않는 미디어 유형일 때의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. | | WAF\$1FILTERED | 403 | 요청이 AWS WAF에 의해 차단될 때의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 `DEFAULT_4XX`입니다. [AWS WAF 사용자 지정 응답](https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html)은 사용자 지정 게이트웨이 응답보다 우선합니다. |