Lixo e Restauro#
Ultralytics Platform implementa uma política de exclusão lógica de 30 dias, permitindo que recuperes projetos, datasets e modelos eliminados acidentalmente. Os itens eliminados são movidos para o Lixo, onde podem ser restaurados antes da eliminação permanente.
Política de Exclusão Lógica#
Quando excluis um recurso na plataforma:
- Imediato: O item move-se para a Lixeira (não é excluído permanentemente)
- 30 Dias: O item permanece recuperável na Lixeira
- Após 30 Dias: O item é excluído permanentemente de forma automática
Tens 30 dias para restaurar qualquer item excluído. Após este período, o item e todos os dados associados são removidos permanentemente e não podem ser recuperados.
Aceder à Lixeira#
Navega até à tua Lixeira:
- Vai a Configurações e clica no separador Lixeira
- Ou navega diretamente para
/trash(redireciona paraSettings > Trash)
Conteúdo da Lixeira#
A Lixeira mostra todos os recursos excluídos temporariamente com guias de filtro, cada uma mostrando uma contagem em tempo real, além de uma caixa de pesquisa que corresponde ao nome e ao tipo:
| Filtro | Mostra |
|---|---|
| Todos | Todos os itens na lixeira |
| Datasets | Datasets na lixeira |
| Projetos | Projetos na lixeira |
| Modelos | Modelos na lixeira |
Visualizar Itens na Lixeira#
Cada item na Lixeira exibe:
| Campo | Descrição |
|---|---|
| Nome | Nome original do recurso |
| Type | Projeto, Dataset ou Modelo (codificado por cores) |
| Excluído | Há quanto tempo o item foi excluído |
| Expira | Dias até a exclusão permanente (por exemplo, "30d"), amarelo âmbar com menos de 15 dias e vermelho com menos de 8 |
| Tamanho | Armazenamento usado pelo item |
| Em cascata | Itens filhos incluídos, mostrados como um emblema +N ao lado do nome |
(As informações do projeto principal são retornadas pela API da Lixeira para modelos, mas não são mostradas na tabela da Lixeira.)
Comportamento em Cascata#
Ao excluir um recurso principal, os recursos dependentes também são movidos para a Lixeira:
| Tipo de Recurso | O que está Incluído ao Excluir |
|---|---|
| Projetos | Projeto + todos os modelos contidos |
| Datasets | Dataset + todas as imagens e anotações |
| Modelos | Pesos do modelo + histórico de treino + exportações |
Enviar um modelo — ou um projeto que contenha um — para a lixeira cancela qualquer treinamento em nuvem que esse modelo tenha em andamento e encerra sua instância de GPU. O tempo de GPU decorrido ainda é cobrado. Consulta Billing.
Treemap de Armazenamento#
O separador Lixeira inclui uma visualização de armazenamento (treemap) que mostra o tamanho relativo dos itens na lixeira, codificados por cores conforme o tipo:
- Azul: Projetos
- Verde: Datasets
- Roxo: Modelos
Restaurar Itens#
Recuperar um item excluído (função Editor ou superior em um espaço de trabalho de equipe):
- Navega para Configurações > Lixeira
- Encontra o item que pretendes restaurar
- Clica no botão Restaurar (ícone de desfazer)
O item retorna à sua localização original com todos os dados intactos.
Se o slug original já estiver ocupado, a plataforma restaura o item com um slug disponível único para que possas aceder ao mesmo imediatamente.
Comportamento de Restauração#
| Recurso | Comportamento de Restauração |
|---|---|
| Projeto | Restaura o projeto e todos os modelos contidos |
| Conjunto de dados | Restaura o dataset com todas as imagens e anotações |
| Modelo | Restaura o modelo para o projeto original se o projeto estiver ativo |
A restauração de um modelo falha se o seu projeto principal estiver na Lixeira. Verás o erro: "Cannot restore model while its parent project is in trash. Restore the project first." Restaura sempre o projeto principal antes de restaurar modelos individuais.
Exclusão Permanente#
Exclusão Automática#
Os itens na Lixeira são excluídos automaticamente e de forma permanente após 30 dias.
Esvaziar Lixeira#
Excluir permanentemente todos os itens de imediato:
- Navega para Configurações > Lixeira
- Clica no ícone de lixeira no cabeçalho
- Confirma a ação
Esvaziar a Lixeira exclui permanentemente todos os itens de imediato. Esta ação não pode ser desfeita e todos os dados serão perdidos, incluindo implementações anexadas, trabalhos de exportação e ficheiros armazenados ligados aos recursos excluídos.
Excluir Item Único Permanentemente#
Para excluir permanentemente um item sem esperar:
- Encontra o item na Lixeira
- Clica no botão Delete permanently (lixeira) na respetiva linha
- Confirma a exclusão — a caixa de diálogo indica o nome do item e quantos modelos em cascata o acompanham
Para projetos, a exclusão permanente também remove implementações associadas e ficheiros de exportação pertencentes aos recursos do espaço de trabalho excluído. Se uma implementação não puder ser excluída, a plataforma avisa-te e deixa-a listada na página Deployments para que possas tentar novamente a partir daí.
Armazenamento e Lixeira#
Os itens na Lixeira continuam a contar para a tua quota de armazenamento:
| Cenário | Impacto no armazenamento |
|---|---|
| Excluir item | O armazenamento permanece alocado |
| Restaurar item | Sem alteração (já estava a contar) |
| Exclusão permanente | Armazenamento libertado |
| Auto-exclusão de 30 dias | Armazenamento libertado automaticamente |
Acesso à API#
Acede ao lixo programaticamente através da REST API. As três operações encontram-se no mesmo
/api/trash caminho e operam no workspace que emitiu a API key — para gerir o lixo de um workspace de equipa, usa uma
API key desse workspace. Os exemplos em Python utilizam o SDK ultralytics-platform:
from ultralytics_platform import Platform
client = Platform() # reads ULTRALYTICS_API_KEYcurl -H "Authorization: Bearer YOUR_API_KEY" \
"https://platform.ultralytics.com/api/trash?type=all&page=1&limit=50"trash = client.lifecycle.trash(type="all", page=1, limit=50)type aceita all, project, dataset ou model. limit tem o valor predefinido de 50 e o limite máximo de 200. A listagem requer
acesso de Leitor (Viewer) ou superior.
A restauração e a exclusão exigem acesso de Editor ou superior.
FAQ#
Não. Após 30 dias, os itens são excluídos permanentemente e não podem ser recuperados. Certifica-te de restaurar itens importantes antes da data de expiração mostrada na Lixeira.
Tanto o projeto como todos os modelos ativos dentro dele vão para o Lixo juntos. Restaurar o projeto restaura os modelos que foram colocados no lixo com ele. Um modelo em cascata não pode ser restaurado enquanto o respetivo projeto principal permanecer no Lixo.
Sim, os itens na Lixeira continuam a usar a quota de armazenamento. Para libertar espaço, exclui permanentemente os itens ou esvazia a Lixeira.
Não. Se um projeto for excluído permanentemente, todos os modelos que estavam dentro dele também são excluídos permanentemente. Restaura sempre os itens antes que a janela de 30 dias expire.
Cada item na Lixeira mostra uma coluna "Expira" com o número de dias (por exemplo, "30d") até que a exclusão permanente automática ocorra.