Lixo e restauro#
A Ultralytics Platform aplica uma política de eliminação lógica de 30 dias, permitindo-te recuperar projetos, conjuntos de dados e modelos eliminados acidentalmente. Os itens eliminados são movidos para a Lixeira, onde podem ser restaurados antes da eliminação permanente.
Política de eliminação lógica#
Quando eliminas um recurso na plataforma:
- Imediatamente: o item é movido para a Lixeira (não é eliminado permanentemente)
- 30 dias: o item permanece recuperável na Lixeira
- Após 30 dias: o item é eliminado permanentemente de forma automática
Tens 30 dias para restaurar qualquer item eliminado. 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 Definições e clica no separador Lixeira
- Ou navega diretamente para
/trash(redireciona paraSettings > Trash)
Conteúdo da Lixeira#
A Lixeira mostra todos os recursos eliminados logicamente com separadores de filtro, cada um apresentando uma contagem em tempo real, além de uma caixa de pesquisa que procura por nome e tipo:
| Filtrar | Apresenta |
|---|---|
| Todas | Todos os itens na Lixeira |
| Conjuntos de dados | Conjuntos de dados na Lixeira |
| Projetos | Projetos na Lixeira |
| Modelos | Modelos na Lixeira |
Ver itens da Lixeira#
Cada item na Lixeira apresenta:
| Campo | Descrição |
|---|---|
| Nome | Nome original do recurso |
| Introduzir | Projeto, conjunto de dados ou modelo (com cores diferentes) |
| Eliminado | Há quanto tempo o item foi eliminado |
| Expira | Dias até à eliminação permanente (por exemplo, "30d"), âmbar abaixo de 15 dias e vermelho abaixo de 8 |
| Tamanho | Armazenamento utilizado pelo item |
| Em cascata | Itens subordinados incluídos, apresentados como um emblema +N junto ao nome |
(As informações do projeto principal são devolvidas pela API da Lixeira para modelos, mas não são apresentadas na tabela da Lixeira.)
Comportamento da cascata#
Quando eliminas um recurso principal, os recursos subordinados também são movidos para a Lixeira:
| Tipo de recurso | O que é incluído ao eliminar |
|---|---|
| Projetos | Projeto + todos os modelos nele contidos |
| Conjuntos de dados | Conjunto de dados + todas as imagens e anotações |
| Modelos | Pesos do modelo + histórico de treino + exportações |
Mover um modelo para a Lixeira — ou um projeto que o contenha — cancela qualquer treino na cloud que esse modelo tenha em curso e termina a respetiva instância de GPU. O tempo de GPU decorrido continua a ser faturado. Consulta Faturação.
Mapa de árvore do armazenamento#
O separador Lixeira inclui uma visualização do armazenamento (mapa de árvore) que mostra o tamanho relativo dos itens na Lixeira, com cores diferentes por tipo:
- Azul: Projetos
- Verde: Conjuntos de dados
- Roxo: Modelos
Restaurar itens#
Recupera um item eliminado (função de Editor ou superior num espaço de trabalho de equipa):
- Navega até Definições > Lixeira
- Encontra o item que queres restaurar
- Clica no botão Restaurar (ícone de anular)
O item retorna ao local original com todos os dados intactos.
Se o slug original já estiver ocupado, a plataforma restaura o item com um slug único disponível para que possas aceder-lhe imediatamente.
Comportamento do restauro#
| Recurso | Comportamento do restauro |
|---|---|
| Projeto | Restaura o projeto e todos os modelos nele contidos |
| Conjunto de dados | Restaura o conjunto de dados com todas as imagens e anotações |
| Modelo | Restaura o modelo para o projeto original se o projeto estiver ativo |
O restauro de um modelo falha se o respetivo 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 restaurares modelos individuais.
Eliminação permanente#
Eliminação automática#
Os itens na Lixeira são eliminados automática e permanentemente após 30 dias.
Esvaziar a Lixeira#
Elimina permanentemente todos os itens de imediato:
- Navega até Definições > Lixeira
- Clica no ícone da Lixeira no cabeçalho
- Confirma a ação
Esvaziar a Lixeira elimina permanentemente todos os itens de imediato. Esta ação não pode ser anulada e todos os dados serão perdidos, incluindo implementações anexadas, tarefas de exportação e ficheiros armazenados associados aos recursos na Lixeira.
Eliminar um único item permanentemente#
Para eliminar permanentemente um item sem esperar:
- Encontra o item na Lixeira
- Clica no botão Eliminar permanentemente (Lixeira) na respetiva linha
- Confirma a eliminação — a caixa de diálogo indica o nome do item e quantos modelos em cascata o acompanham
Para projetos, a eliminação permanente também remove as implementações relacionadas e os ficheiros de exportação pertencentes aos recursos do espaço de trabalho eliminado. Se não for possível eliminar uma implementação, a Platform avisa-te e mantém-na listada na página Implementações 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 |
|---|---|
| Eliminar item | O armazenamento continua alocado |
| Restaurar item | Sem alterações (continuava a contar) |
| Eliminação permanente | Armazenamento libertado |
| Eliminação automática após 30 dias | Armazenamento libertado automaticamente |
Se estiveres a ficar sem armazenamento, esvazia a Lixeira ou elimina permanentemente itens específicos para recuperares espaço imediatamente. Consulta a utilização do armazenamento em Definições e vê Faturação para conheceres os limites de armazenamento do plano.
Acesso à API#
Acede à Lixeira programaticamente através da REST API. Todas as três operações estão no mesmo caminho /api/trash e atuam sobre o espaço de trabalho que emitiu a chave da API — para gerir a Lixeira de um espaço de trabalho de equipa, usa uma chave da API desse espaço de trabalho. Os exemplos de 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 assume o valor predefinido de 50 e está limitado a 200. A listagem requer acesso de Viewer ou superior.
O restauro e a eliminação requerem acesso de Editor ou superior.
Perguntas frequentes#
Não. Após 30 dias, os itens são eliminados permanentemente e não podem ser recuperados. Certifica-te de que restauras os itens importantes antes da data de validade apresentada na Lixeira.
Tanto o projeto como todos os modelos ativos nele são movidos para a Lixeira em conjunto. Restaurar o projeto restaura os modelos que foram enviados para a Lixeira com ele. Um modelo em cascata não pode ser restaurado enquanto o projeto principal permanecer na Lixeira.
Sim, os itens na Lixeira continuam a utilizar a quota de armazenamento. Para libertar espaço, elimina permanentemente os itens ou esvazia a Lixeira.
Não. Se um projeto for eliminado permanentemente, todos os modelos que estavam nele também serão eliminados permanentemente. Restaura sempre os itens antes de expirar o período de 30 dias.
Cada item na Lixeira apresenta uma coluna "Expires" com o número de dias (por exemplo, "30d") até ocorrer a eliminação permanente automática.