> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/rules-engine/trash-and-recovery.md).

# Lixo e Recuperação

As regras eliminadas suavemente vão para o Lixo — reveja-as e restaure-as dentro do período de recuperação antes da remoção.

Eliminar uma regra não a destrói imediatamente. A plataforma utiliza eliminação suave — as regras removidas são movidas para uma área de lixo onde podem ser revistas e restauradas. Isto protege contra eliminações acidentais e dá às equipas uma janela de recuperação antes de algo desaparecer permanentemente.

## Eliminar uma regra

### Quem pode eliminar

Qualquer utilizador com permissões de edição na regra pode eliminá-la, desde que a regra não esteja atualmente bloqueada por outro utilizador. Se aparecer um ícone de bloqueio na regra, o botão Eliminar fica desativado — aguarde que o bloqueio seja libertado ou peça a um proprietário da organização para o desbloquear à força.

### Como eliminar

1. Abra o **Regras** separador na página do motor de regras.
2. Encontre a regra que pretende eliminar.
3. Clique no **Eliminar** botão na linha da regra.
4. É apresentada uma caixa de diálogo de confirmação:

   > **"Tem a certeza de que pretende eliminar a regra?"** "A regra será desativada e armazenada no lixo. Pode restaurar a regra a partir do lixo."
5. Clique em **Mover para o lixo** para confirmar.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-e7e1b4af763bb5adaccd437f0f4796a580a16122%2Frules-delete-confirm.jpg?alt=media" alt="The delete confirmation dialog explaining that the rule is stored in the trash, with Cancel and Move to trash"><figcaption></figcaption></figure>

A regra é removida da lista ativa de Regras e aparece no separador Lixo. Se a regra tivesse um artefacto em execução, o artefacto é parado como parte da eliminação.

## O separador Lixo

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-d4aa70e4ecf17b078d34cdb6db219eac800c2043%2Frules-trash.jpg?alt=media" alt="The Trash tab listing a deleted rule with its description, deleted time and the Restore rule action"><figcaption></figcaption></figure>

\### Como chegar lá

Na página do motor de regras em `/rules`, clique no **Lixo** separador (o terceiro separador, depois de Regras e Artefactos).

### O que vê

O separador Lixo mostra uma tabela de todas as regras eliminadas que ainda estão dentro da janela de retenção:

| Coluna                 | Descrição                                                              |
| ---------------------- | ---------------------------------------------------------------------- |
| **Nome**               | O nome da regra e a sua descrição                                      |
| **Hora da eliminação** | Quando a regra foi movida para o lixo, formatado como "dd.MM.yy HH:mm" |

### Estado vazio

Se nenhuma regra tiver sido eliminada (ou se todas as regras eliminadas tiverem ultrapassado a janela de retenção), o separador mostra: *"O lixo está vazio"* com a mensagem *"As regras eliminadas aparecerão aqui."*

## Restaurar uma regra

Restaurar uma regra move-a de volta para a lista ativa de Regras, onde pode ser editada, compilada e implementada novamente.

### Como restaurar

1. Abra o **Lixo** separador na página do motor de regras.
2. Encontre a regra que pretende restaurar.
3. Clique em **Restaurar regra** na linha.
4. É apresentada uma caixa de diálogo de confirmação:

   > "A regra será ativada e movida de volta para a lista de regras ativas."
5. Clique em **Restaurar** para confirmar.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-f0723c487f47f0fde012e59c048d006e76742388%2Frules-restore-confirm.jpg?alt=media" alt="The restore confirmation dialog explaining that the rule will be activated and moved back to the active rules list"><figcaption></figcaption></figure>

Nada acontece até confirmar — fechar a caixa de diálogo deixa a regra no lixo.

A regra reaparece no separador Regras. Volta **desbloqueada**, independentemente do estado de bloqueio quando foi eliminada.

### Como fica uma regra restaurada

* A regra aparece no separador Regras com o nome original, a descrição e o histórico completo de versões intactos.
* A regra não está implementada. Mesmo que tivesse um artefacto em execução antes da eliminação, é necessário compilá-la e implementá-la novamente antes de poder responder ao sensor selecionado ou à origem do acionador.
* A regra está desbloqueada, por isso qualquer membro da equipa com permissões de edição pode abri-la e trabalhar nela imediatamente.

### Limitações da restauração

* **Janela de retenção.** As regras permanecem no lixo durante um período limitado. Quando uma regra ultrapassa a janela de retenção, é eliminada permanentemente e não pode ser recuperada.
* **Limites da subscrição.** Restaurar uma regra conta para o limite de regras da sua organização. Se a sua organização já tiver atingido o número máximo de regras ativas, a restauração não prosseguirá até libertar capacidade — seja eliminando outra regra ativa ou atualizando o seu plano.

## Boas práticas

* **Verifique o lixo antes de recriar uma regra.** Se um colega eliminou uma regra de que ainda precisa, restaurá-la é mais rápido do que recriá-la do zero — e preserva todo o histórico de versões.
* **Não confie no lixo como arquivo.** A janela de retenção é limitada. Se quiser preservar uma regra a longo prazo, mas mantê-la inativa, considere parar o artefacto implementado em vez de eliminar a regra.
* **Coordene as eliminações com a sua equipa.** A eliminação suave protege contra acidentes, mas comunicar a intenção evita confusão sobre o motivo de uma regra ter desaparecido da lista ativa.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/rules-engine/trash-and-recovery.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
