---
name: azion-como-configurar-paginas-de-erro
description: >-
  Defina o TTL do cache para erros recebidos da origem e personalize as páginas de erro para o seu usuário final.
---

# Como configurar páginas de erro

> **Importante**
>
> Estamos lançando uma atualização significativa em nossa plataforma. Para saber mais sobre as mudanças e etapas de migração necessárias, consulte a [página de rollout da API v4](/pt-br/documentacao/fundamentos/api-v4-migration/).

Com este guia, você irá modificar a resposta de erro padrão da sua aplicação, definindo um TTL de cache para cada erro recebido da origem.

Existem instruções separadas para API v3 usando as configurações legadas de [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/) e API v4 usando o novo produto [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages).

> **Dica**
>
> Se você não tem certeza de quais etapas se aplicam à sua conta, veja [o guia Verificar migração da conta](/pt-br/documentacao/guias/seguranca-de-aplicacoes/acesso-e-compliance/verificar-migracao-conta/) para determinar se sua conta já foi migrada.

**Console - Custom Pages**

Configure sua application para lidar com respostas de erro da origem usando [Custom Pages](/pt-br/documentacao/plataforma/workloads/#custom-pages). A Azion permite que você defina um TTL de cache para páginas de erro, um caminho personalizado ou entregue outro código HTTP na resposta sem precisar alterar o código-fonte da sua aplicação.

---

1. Acesse o [Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/) > **Custom Pages**.
2. Clique em **+ Custom Page**.
3. Na seção **Page Codes**, clique em **+ Custom Page Code** para adicionar uma página para um código de status escolhido. Por exemplo: `404`.
4. No novo campo **Page Code**, selecione o código de status que deseja personalizar.
5. No campo **Connector**, selecione o [Connector](/pt-br/documentacao/plataforma/connectors/) que está buscando os dados da sua origem.
6. No campo **Page Path**, adicione um *path* para uma página de erro criada na origem. Por exemplo: `/error/404`.
7. Em **Response TTL**, defina o *time-to-live* (TTL) do cache, em segundos.
8. No campo **Response Custom Status Code**, personalize o status HTTP que será recebido pelo usuário.
9. Clique no botão **Apply**.

Agora vamos vincular a Custom Page ao seu [Workload](/pt-br/documentacao/plataforma/workloads/):

1. Acesse o [Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/) > **Workloads**.
2. Edite o Workload desejado.
3. Na seção **Deployment Settings**, selecione sua Custom Page.
4. Clique no botão **Save**.

Quando forem recebidos erros do Connector, sua application irá armazená-los em cache e exibir a página de erro com base na nova configuração.

**Console - Error Responses**

Configure sua application para lidar com respostas de erro da origem usando [Error Responses](/pt-br/documentacao/plataforma/workloads/custom-pages/error-responses/). A Azion permite que você defina um TTL de cache para páginas de erro, um caminho personalizado ou entregue outro código HTTP na resposta sem precisar alterar o código-fonte da sua aplicação.

Com este guia, você irá modificar a resposta de erro padrão da sua aplicação, definindo um TTL de cache para cada erro recebido da origem.

---

1. Acesse o [Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/) > **Applications**.
2. Clique na application que você deseja configurar.
3. Selecione a aba **Error Responses**.

Na seção **Error Responses**, o campo **Status Code** não pode ser modificado. Este campo representa todos os códigos de erro recebidos da origem. O campo **Default Response TTL** permite que você personalize o TTL de cache para todos os códigos recebidos.

4. Em **Default Response TTL**, defina o *time-to-live* (TTL) do cache, em segundos, para todas as páginas de erro.
5. Clique no botão **+ Error Response**.
6. No novo campo **Status Code**, selecione o código de status que você deseja personalizar. Por exemplo: `404`.
7. Adicione um TTL de cache no campo **Custom Response TTL**.

Você também pode determinar um caminho específico da sua origem que será entregue ao usuário e um código de status personalizado na resposta. Essas modificações são opcionais.

8. No campo **Page Path**, adicione um *path* para uma página de erro criada na origem. Por exemplo: `/error/404`.
9. No campo **Response Status Code**, personalize o status HTTP que será recebido pelo usuário.
10. Na seção **Set Origin**, selecione a origem das URIs da página de erro.
11. Clique no botão **Save**.

Quando erros forem recebidos da origem, sua application irá armazenar em cache e exibir a página de erro com base na nova configuração.
