쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

API Gateway의 게이트웨이 응답 유형

포커스 모드
API Gateway의 게이트웨이 응답 유형 - Amazon API Gateway

API Gateway에서는 API 개발자가 사용자 지정할 수 있도록 다음과 같은 게이트웨이 응답을 공개합니다.

게이트웨이 응답 유형 기본 상태 코드 설명
ACCESS_DENIED 403

권한 부여 실패(예: 사용자 지정 또는 Amazon Cognito 권한 부여자가 액세스를 거부한 경우)에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

API_CONFIGURATION_ERROR 500

유효하지 않은 엔드포인트 주소가 제출된 경우, 이진 지원이 수행될 때 이진 데이터에 대해 base64 디코딩이 실패한 경우, 통합 응답 매핑이 어떤 템플릿과도 일치할 수 없어서 기본 템플릿이 구성되어 있지 않은 경우를 포함하여 유효하지 않은 API 구성에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_5XX입니다.

AUTHORIZER_CONFIGURATION_ERROR 500

사용자 지정 또는 Amazon Cognito 권한 부여자 연결 실패에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_5XX입니다.

AUTHORIZER_FAILURE 500

사용자 지정 또는 Amazon Cognito 권한 부여자가 호출자를 인증하지 못한 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_5XX입니다.

BAD_REQUEST_PARAMETERS 400

활성화된 요청 검사기에 따라 요청 파라미터를 확인할 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

BAD_REQUEST_BODY 400

활성화된 요청 검사기에 따라 요청 본문을 확인할 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

DEFAULT_4XX Null

상태 코드가 4XX인 지정되지 않은 응답 유형에 대한 기본 게이트웨이 응답입니다. 이 대체 게이트웨이 응답의 상태 코드를 변경하면 모든 다른 4XX 응답의 상태 코드가 새 값으로 변경됩니다. 이 상태 코드를 null로 재설정하면 모든 다른 4XX 응답의 상태 코드가 원래 값으로 되돌아갑니다.

참고

AWS WAF 사용자 지정 응답은 사용자 지정 게이트웨이 응답보다 우선합니다.

DEFAULT_5XX Null

상태 코드가 5XX인 지정되지 않은 응답 유형에 대한 기본 게이트웨이 응답입니다. 이 대체 게이트웨이 응답의 상태 코드를 변경하면 모든 다른 5XX 응답의 상태 코드가 새 값으로 변경됩니다. 이 상태 코드를 null로 재설정하면 모든 다른 5XX 응답의 상태 코드가 원래 값으로 되돌아갑니다.

EXPIRED_TOKEN 403

AWS 인증 토큰 만료 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

INTEGRATION_FAILURE 504

통합 실패 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_5XX입니다.

INTEGRATION_TIMEOUT 504

통합 시간 초과 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_5XX입니다.

INVALID_API_KEY 403

API 키를 요구하는 메서드에 대해 제출되는 잘못된 API 키에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

INVALID_SIGNATURE 403

잘못된 AWS 서명 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

MISSING_AUTHENTICATION_TOKEN 403

클라이언트가 지원되지 않는 API 메서드 또는 리소스를 호출하려고 시도하는 경우를 비롯한 누락된 인증 토큰 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

QUOTA_EXCEEDED 429

사용량 계획 할당량 초과 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

REQUEST_TOO_LARGE 413

요청이 너무 큼 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본값은 HTTP content length exceeded 10485760 bytes입니다.

RESOURCE_NOT_FOUND 404

API 키 인증 및 권한 부여를 제외하고 API 요청에서 인증 및 권한 부여를 전달한 이후에 API Gateway에서 지정된 리소스를 찾을 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

THROTTLED 429

사용량 계획, 메서드, 단계 또는 계정 수준 조절 한도가 초과한 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

UNAUTHORIZED 401

사용자 지정 또는 Amazon Cognito 권한 부여자가 호출자를 인증하지 못한 경우의 게이트웨이 응답입니다.

UNSUPPORTED_MEDIA_TYPE 415

엄격한 패스스루 동작을 활성화한 경우에 페이로드가 지원되지 않는 미디어 유형일 때의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

WAF_FILTERED 403

요청이 AWS WAF에 의해 차단될 때의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 DEFAULT_4XX입니다.

참고

AWS WAF 사용자 지정 응답은 사용자 지정 게이트웨이 응답보다 우선합니다.

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.