# API Gateway でのゲートウェイレスポンスタイプ API Gateway では、API デベロッパーがカスタマイズできる以下のゲートウェイレスポンスを公開しています。 | ゲートウェイレスポンスのタイプ | デフォルトのステータスコード | 説明 | | --- | --- | --- | | ACCESS\_DENIED | 403 | 認可が失敗した場合のゲートウェイレスポンス—たとえば、カスタムまたは Amazon Cognito オーソライザーによってアクセスが拒否された場合などが該当します。レスポンスタイプが未指定の場合、このレスポンスはデフォルトで `DEFAULT_4XX` タイプになります。 | | API\_CONFIGURATION\_ERROR | 500 | API 設定が無効な場合のゲートウェイレスポンス — たとえば、無効なエンドポイントアドレスが送信された場合、バイナリサポートが有効になっているときにバイナリデータに対する Base64 デコーディングが失敗した場合、統合レスポンスマッピングがいずれのテンプレートとも一致せず、デフォルトテンプレートも設定されていない場合などが該当します。レスポンスタイプが未指定の場合、このレスポンスはデフォルトで `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 カスタムレスポンス](https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html)は、カスタムゲートウェイレスポンスよりも優先されます。 | | 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 カスタムレスポンス](https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html)は、カスタムゲートウェイレスポンスよりも優先されます。 |