# Como personalizar uma página de resposta de erro

import DocButton from '~/components/webkit/DocButton.vue';
import Tabs from '~/components/tabs/Tabs'
import Apiv4Rollout from '~/includes/snippets/apiv4Rollout/pt/snippet.mdx'

<Apiv4Rollout />

Descubra como configurar sua application da Azion para mostrar páginas de erro personalizadas para seu usuário baseadas em códigos de status de erro HTTP. Para este guia, você já deve ter uma Applications, um Connectors e um Workload configurados.

Existem instruções separadas para API v3 usando configurações de [Error Responses legados](/pt-br/documentacao/produtos/build/applications/error-responses/) e API v4 usando o novo produto [Custom Pages](/pt-br/documentacao/produtos/secure/custom-pages/).

:::tip
Se você não tem certeza de quais etapas se aplicam à sua conta, consulte [o guia Verificar Migração da Conta](/pt-br/documentacao/produtos/guias/verificar-migracao-conta/) para determinar se sua conta já foi migrada.
:::

<Tabs client:visible>
    <Fragment slot="tab.consolecustompages">Console - Custom Pages</Fragment>
    <Fragment slot="tab.consoleerrorresponses">Console - Error Responses</Fragment>


<Fragment slot="panel.consolecustompages">

Para criar uma Custom Page, siga os passos:

1. Acesse o [Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Custom Pages**.
2. Clique no botão **+ Custom Page**.
3. Para personalizar códigos de erro específicos, clique no botão **+ Custom Page Code**.
4. Selecione o **Page Code**, que representa o código recebido do Connectors ao buscar seu conteúdo.
5. Selecione o **Connectors**.
6. No campo **Page Path**, você pode adicionar um *path* para uma página de erro criada na sua origem.
7. Altere o TTL de cache no campo **Response TTL**.
8. No campo **Response Custom Status Code**, você pode personalizar o status HTTP que será recebido pelo usuário.
9. Clique no botão **Save**.

Agora para vincular suas Error Pages ao seu Workload, siga os passos:

1. Acesse o [Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Workloads**.
2. Na seção Deployment Settings, selecione a Custom Page que você criou.
3. Clique no botão **Save**.


Pronto. Sua application agora exibirá uma página de erro com a nova configuração.

</Fragment>
<Fragment slot="panel.consoleerrorresponses">

Para personalizar a página de resposta de erro, siga os passos:

1. Acesse o [Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Applications**.
2. Selecione a aplicação vinculada ao domínio que necessita da nova página de erro.
3. Selecione a aba **Error Responses**.
4. O primeiro campo **Status Code** está desabilitado, mas em **Default Response TTL** você pode definir o *time-to-live* (TTL), em segundos, para o cache de todas as páginas de erro.
    - O primeiro código de status da lista é reservado para a definição de cache de páginas cujo erro não foi contemplado pela aplicação.
5. Para personalizar códigos de erro específicos, clique no botão **+ Add Error Response**.
6. No novo campo **Status Code**, selecione o código de status que você deseja customizar.
7. Altere o TTL de cache no campo **Custom Response TTL**.
   - Você pode manter o mesmo TTL de cache definido no campo anterior ou adicionar um TTL diferente.
8. No campo **Page Path**, você pode adicionar um *path* para uma página de erro criada na origem.
9. No campo **Response Status Code**, você pode customizar o status HTTP que será recebido pelo usuário.
10. Na seção **Set Origin**, você pode definir a origem das URIs das páginas de erro.
    - Você pode configurar suas origens na aba **Origins** da aplicação.
11. Clique no botão **Save**.

Pronto. Sua página de resposta de erro será exibida com a nova configuração.

</Fragment>
</Tabs>

---