# Tipos de resposta de gateway do API Gateway O API Gateway expõe as seguintes respostas de gateway para personalização pelos desenvolvedores de APIs. | Tipo de resposta do Gateway | Código de status de padrão | Descrição | | --- | --- | --- | | ACCESS\_DENIED | 403 | A resposta de gateway para uma falha de autorização; por exemplo, quando o acesso é negado por um autorizador personalizado ou do Amazon Cognito. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | API\_CONFIGURATION\_ERROR | 500 | A resposta do gateway para uma configuração de API inválida, incluindo quando um endereço de endpoint inválido é enviado, quando a decodificação em base64 falha nos dados binários quando o suporte binário está implementado ou quando o mapeamento da resposta de integração não pode corresponder a nenhum modelo e nenhum modelo padrão está configurado. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_5XX`. | | AUTHORIZER\_CONFIGURATION\_ERROR | 500 | A resposta de gateway por não conseguir se conectar a um autorizador personalizado ou do Amazon Cognito. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_5XX`. | | AUTHORIZER\_FAILURE | 500 | A resposta de gateway quando um autorizador personalizado ou do Amazon Cognito falhou ao autenticar o autor da chamada. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_5XX`. | | BAD\_REQUEST\_PARAMETERS | 400 | A resposta de gateway quando o parâmetro de solicitação não pode ser validado de acordo com um validador de solicitação ativado. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | BAD\_REQUEST\_BODY | 400 | A resposta de gateway quando o corpo da solicitação não pode ser validado de acordo com um validador de solicitação ativado. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | DEFAULT\_4XX | Nulo | A resposta de gateway padrão para um tipo de resposta não especificado com o código de status de `4XX`. Alterar o código de status dessa resposta de gateway de retorno altera os códigos de status de todas as outras respostas `4XX` para o novo valor. Redefinir esse código de status para nulo reverte os códigos de status de todas as outras respostas `4XX` para seus valores originais. As [respostas personalizadas do AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html) têm precedência sobre as respostas personalizadas do gateway. | | DEFAULT\_5XX | Nulo | A resposta de gateway padrão para um tipo de resposta não especificado com um código de status de `5XX`. Alterar o código de status dessa resposta de gateway de retorno altera os códigos de status de todas as outras respostas `5XX` para o novo valor. Redefinir esse código de status para nulo reverte os códigos de status de todas as outras respostas `5XX` para seus valores originais. | | EXPIRED\_TOKEN | 403 | A resposta de gateway para um erro de token de autenticação do AWS expirado. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | INTEGRATION\_FAILURE | 504 | A resposta de gateway para um erro de integração com falha. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_5XX`. | | INTEGRATION\_TIMEOUT | 504 | A resposta de gateway para um erro de tempo limite de integração. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_5XX`. | | INVALID\_API\_KEY | 403 | A resposta do gateway para uma chave de API inválida enviada para um método que requer uma chave de API. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | INVALID\_SIGNATURE | 403 | A resposta do gateway para um erro de assinatura da AWS inválido. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | MISSING\_AUTHENTICATION\_TOKEN | 403 | A resposta de gateway para um erro de token de autenticação ausente, incluindo casos quando o cliente tenta invocar um método de API ou recurso sem suporte. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | QUOTA\_EXCEEDED | 429 | A resposta de gateway para o erro de cota de plano de uso excedida. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | REQUEST\_TOO\_LARGE | 413 | A resposta de gateway para o erro de solicitação muito grande. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão: `HTTP content length exceeded 10485760 bytes`. | | RESOURCE\_NOT\_FOUND | 404 | A resposta de gateway quando o API Gateway não consegue localizar o recurso especificado depois que uma solicitação de API passa na autenticação e na autorização, exceto para a autorização e a autenticação da chave de API. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | THROTTLED | 429 | A resposta de gateway quando limites de controle de fluxo em nível de plano de uso, método, estágio ou conta são excedidos. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | UNAUTHORIZED | 401 | A resposta de gateway quando o autorizador personalizado ou do Amazon Cognito falhou ao autenticar o autor da chamada. | | UNSUPPORTED\_MEDIA\_TYPE | 415 | A resposta de gateway quando a carga é de um tipo de mídia sem suporte, se o comportamento de passagem direta estrita estiver habilitado. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. | | WAF\_FILTERED | 403 | A resposta de gateway quando uma solicitação é bloqueada pelo AWS WAF. Se o tipo de resposta não for especificado, essa resposta assumirá como padrão o tipo `DEFAULT_4XX`. As [respostas personalizadas do AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html) têm precedência sobre as respostas personalizadas do gateway. |