

# Código de status HTTP 503 (Serviço indisponível)
<a name="http-503-service-unavailable"></a>

Um código de status HTTP 503 (Serviço indisponível) normalmente indica um problema de performance no servidor de origem. Em casos raros, ele indica que o CloudFront não pode atender a uma solicitação temporariamente devido a uma limitação de recursos em um local da borda.

Se você estiver usando o Lambda@Edge ou o CloudFront Functions, o problema pode ser um erro de execução ou um erro de limite excedido do Lambda@Edge.

**Topics**
+ [O servidor de origem não tem capacidade suficiente para oferecer suporte à taxa de solicitação](#http-503-service-unavailable-not-enough-origin-capacity)
+ [O CloudFront provocou o erro devido a restrições de recursos no local da borda](#http-503-service-unavailable-limited-resources-at-edge-location)
+ [Erro de execução do Lambda@Edge ou do CloudFront Function](#http-503-lambda-execution-error)
+ [Limite do Lambda@Edge excedido](#http-503-lambda-limit-exceeded-error)

## O servidor de origem não tem capacidade suficiente para oferecer suporte à taxa de solicitação
<a name="http-503-service-unavailable-not-enough-origin-capacity"></a>

Quando um servidor de origem não está disponível ou não consegue atender às solicitações recebidas, ele exibe um código de status HTTP 503 (serviço indisponível). O CloudFront então transmite o erro de volta para o usuário. Para resolver esse problema, tente as seguintes soluções:
+ **Se você usa o Amazon S3 como servidor de origem**:
  + É possível enviar 3.500 solicitações PUT/COPY/POST/DELETE ou 5.500 solicitações GET/HEAD por segundo por prefixo particionado do Amazon S3. Quando o Amazon S3 exibe uma resposta 503 Slow Down, isso normalmente indica uma taxa de solicitação excessiva em relação a um prefixo específico do Amazon S3.

    Como as taxas de solicitação se aplicam por prefixo em um bucket do S3, os objetos devem ser distribuídos em vários prefixos. À medida que a taxa de solicitação nos prefixos aumenta de forma gradual, o Amazon S3 aumenta a escala verticalmente para lidar com as solicitações de cada um dos prefixos de maneira separada. Como resultado, a taxa geral de solicitações processada pelo bucket é um múltiplo do número de prefixos.
  + Para obter mais detalhes, consulte [Otimizar a performance do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/optimizing-performance.html), no *Guia do usuário do Amazon Simple Storage Service*.
+ **Se você usar o Elastic Load Balancing como servidor de origem**:
  + Garanta que suas instâncias de back-end possam responder às verificações de integridade.
  + Garanta que o balanceador de carga e as instâncias de back-end possam lidar com a carga.

  Para obter mais informações, consulte:
  + [Como soluciono erros 503 exibidos ao usar o Classic Load Balancer?](https://repost.aws/knowledge-center/503-error-classic)
  + [Como soluciono erros 503 (serviço indisponível) do Application Load Balancer?](https://repost.aws/knowledge-center/alb-troubleshoot-503-errors)
+ **Se você usa uma origem personalizada**:
  + Examine os logs da aplicação para garantir que a origem tenha recursos suficientes, como memória, CPU e tamanho do disco.
  + Se você usa o Amazon EC2 como o backend, verifique se o tipo de instância tem os recursos apropriados para atender às solicitações recebidas. Para ter mais informações, consulte [Instance types](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html), no *Guia do usuário do Amazon EC2*.
+ **Se você usa o API Gateway**:
  + Esse erro está relacionado à integração de back-end quando a API do API Gateway não consegue receber uma resposta. O servidor de back-end pode estar:
    + Sobrecarregado além da capacidade e incapaz de processar novas solicitações de clientes.
    + Em manutenção temporária.
  + Para resolver esse erro, consulte os logs da aplicação do API Gateway para determinar se há algum problema com a capacidade de back-end, a integração ou qualquer outra coisa.

## O CloudFront provocou o erro devido a restrições de recursos no local da borda
<a name="http-503-service-unavailable-limited-resources-at-edge-location"></a>

Você receberá esse erro se o CloudFront não puder encaminhar solicitações ao melhor local da borda seguinte disponível e, portanto, não poderá atender a uma solicitação. Esse erro é comum ao executar testes de carga na distribuição do CloudFront. Para evitar isso, siga as diretrizes de [Testes de carga do CloudFront](load-testing.md) para evitar erros 503 (capacidade excedida).

Se isso acontecer no ambiente de produção, entre em contato com o [Suporte](https://console.aws.amazon.com/support/home#/).

## Erro de execução do Lambda@Edge ou do CloudFront Function
<a name="http-503-lambda-execution-error"></a>

Se você estiver usando o Lambda@Edge ou o CloudFront Functions, um código de status HTTP 503 pode indicar que sua função retornou um erro de execução. 

Para ter mais detalhes sobre como identificar e resolver erros do Lambda@Edge, consulte [Testar e depurar as funções do Lambda@Edge](lambda-edge-testing-debugging.md).

Para ter mais informações sobre como testar o CloudFront Functions, consulte [Testar funções](test-function.md).

## Limite do Lambda@Edge excedido
<a name="http-503-lambda-limit-exceeded-error"></a>

Se você estiver usando o Lambda@Edge, um código de status HTTP 503 poderá indicar que o Lambda exibiu um erro. O erro pode ser causado por uma das seguintes situações:
+ O número de execuções de função excedeu uma das cotas que o Lambda define para limitar as execuções em uma Região da AWS (execuções simultâneas ou frequência de invocação).
+ A função excedeu a cota de tempo limite da função do Lambda.

Para ter mais informações sobre as cotas do Lambda@Edge, consulte [Cotas do Lambda@Edge](cloudfront-limits.md#limits-lambda-at-edge). Para ter mais detalhes sobre como identificar e resolver erros do Lambda@Edge, consulte [Testar e depurar as funções do Lambda@Edge](lambda-edge-testing-debugging.md). Você também pode ver as [Cotas do serviço do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html) no *Guia do desenvolvedor do AWS Lambda*. 