API Gateway에서는 API 개발자가 사용자 지정할 수 있도록 다음과 같은 게이트웨이 응답을 공개합니다.
게이트웨이 응답 유형 | 기본 상태 코드 | 설명 |
---|---|---|
ACCESS_DENIED |
403 |
권한 부여 실패(예: 사용자 지정 또는 Amazon Cognito 권한 부여자가 액세스를 거부한 경우)에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
API_CONFIGURATION_ERROR |
500 |
유효하지 않은 엔드포인트 주소가 제출된 경우, 이진 지원이 수행될 때 이진 데이터에 대해 base64 디코딩이 실패한 경우, 통합 응답 매핑이 어떤 템플릿과도 일치할 수 없어서 기본 템플릿이 구성되어 있지 않은 경우를 포함하여 유효하지 않은 API 구성에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
AUTHORIZER_CONFIGURATION_ERROR |
500 |
사용자 지정 또는 Amazon Cognito 권한 부여자 연결 실패에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
AUTHORIZER_FAILURE |
500 |
사용자 지정 또는 Amazon Cognito 권한 부여자가 호출자를 인증하지 못한 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
BAD_REQUEST_PARAMETERS |
400 |
활성화된 요청 검사기에 따라 요청 파라미터를 확인할 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
BAD_REQUEST_BODY |
400 |
활성화된 요청 검사기에 따라 요청 본문을 확인할 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
DEFAULT_4XX |
Null | 상태 코드가 참고AWS WAF 사용자 지정 응답은 사용자 지정 게이트웨이 응답보다 우선합니다. |
DEFAULT_5XX |
Null | 상태 코드가 |
EXPIRED_TOKEN |
403 |
AWS 인증 토큰 만료 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
INTEGRATION_FAILURE |
504 |
통합 실패 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
INTEGRATION_TIMEOUT |
504 |
통합 시간 초과 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
INVALID_API_KEY |
403 |
API 키를 요구하는 메서드에 대해 제출되는 잘못된 API 키에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
INVALID_SIGNATURE |
403 |
잘못된 AWS 서명 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
MISSING_AUTHENTICATION_TOKEN |
403 |
클라이언트가 지원되지 않는 API 메서드 또는 리소스를 호출하려고 시도하는 경우를 비롯한 누락된 인증 토큰 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
QUOTA_EXCEEDED |
429 |
사용량 계획 할당량 초과 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
REQUEST_TOO_LARGE |
413 |
요청이 너무 큼 오류에 대한 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본값은 |
RESOURCE_NOT_FOUND |
404 |
API 키 인증 및 권한 부여를 제외하고 API 요청에서 인증 및 권한 부여를 전달한 이후에 API Gateway에서 지정된 리소스를 찾을 수 없는 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
THROTTLED |
429 |
사용량 계획, 메서드, 단계 또는 계정 수준 조절 한도가 초과한 경우의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
UNAUTHORIZED |
401 |
사용자 지정 또는 Amazon Cognito 권한 부여자가 호출자를 인증하지 못한 경우의 게이트웨이 응답입니다. |
UNSUPPORTED_MEDIA_TYPE |
415 |
엄격한 패스스루 동작을 활성화한 경우에 페이로드가 지원되지 않는 미디어 유형일 때의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 |
WAF_FILTERED |
403 |
요청이 AWS WAF에 의해 차단될 때의 게이트웨이 응답입니다. 응답 유형이 지정되지 않은 경우 이 응답의 기본 유형은 참고AWS WAF 사용자 지정 응답은 사용자 지정 게이트웨이 응답보다 우선합니다. |