휴지통 및 복원#
Ultralytics Platform은 30일 소프트 삭제 정책을 적용하므로 실수로 삭제한 프로젝트, 데이터셋 및 모델을 복구할 수 있습니다. 삭제된 항목은 휴지통으로 이동되며 영구 삭제되기 전에 복원할 수 있습니다.
소프트 삭제 정책#
플랫폼에서 리소스를 삭제하면 다음과 같이 처리됩니다:
- 즉시: 항목이 휴지통으로 이동합니다(영구 삭제되지 않음).
- 30일: 항목을 휴지통에서 복구할 수 있습니다.
- 30일 후: 항목이 자동으로 영구 삭제됩니다.
삭제된 항목은 30일 이내에 복원할 수 있습니다. 이 기간이 지나면 항목과 관련 데이터가 모두 영구 삭제되어 복구할 수 없습니다.
휴지통에 액세스하기#
휴지통으로 이동합니다:
- 설정으로 이동한 후 휴지통 탭을 클릭합니다
- 또는
/trash으로 바로 이동합니다(Settings > Trash로 리디렉션됨).
휴지통 내용#
휴지통에는 소프트 삭제된 모든 리소스가 표시됩니다. 각 필터 탭에는 현재 개수가 표시되며, 이름과 유형으로 검색할 수 있는 검색창도 제공됩니다:
| 필터 | 표시 항목 |
|---|---|
| 전체 | 휴지통에 있는 모든 항목 |
| 데이터셋 | 휴지통에 있는 데이터셋 |
| 프로젝트 | 휴지통에 있는 프로젝트 |
| 모델 | 휴지통에 있는 모델 |
휴지통 항목 보기#
휴지통의 각 항목에는 다음 정보가 표시됩니다:
| 필드 | 설명 |
|---|---|
| 이름 | 원래 리소스 이름 |
| 입력 | 프로젝트, 데이터셋 또는 모델(색상으로 구분) |
| 삭제됨 | 항목이 삭제된 지 얼마나 되었는지 |
| 만료 | 영구 삭제까지 남은 일수(예: "30d")이며, 15일 미만이면 황색, 8일 미만이면 빨간색으로 표시됩니다. |
| 크기 | 항목이 사용하는 스토리지 |
| 하위 항목 포함 | 포함된 하위 항목은 이름 옆에 +N 배지로 표시됩니다. |
(모델의 경우 상위 프로젝트 정보가 Trash API에서 반환되지만 휴지통 표에는 표시되지 않습니다.)
하위 항목 처리 방식#
상위 리소스를 삭제하면 하위 리소스도 휴지통으로 이동합니다:
모델 또는 모델이 포함된 프로젝트를 휴지통으로 이동하면 해당 모델의 진행 중인 클라우드 학습이 취소되고 GPU 인스턴스가 종료됩니다. 경과된 GPU 사용 시간은 계속 과금됩니다. 결제를 참조하세요.
스토리지 트리맵#
휴지통 탭에는 휴지통 항목의 상대적 크기를 유형별 색상으로 표시하는 스토리지 시각화(트리맵)가 포함됩니다:
- 파란색: 프로젝트
- 초록색: 데이터셋
- 보라색: 모델
항목 복원#
삭제된 항목을 복구합니다(팀 워크스페이스에서 편집자 역할 이상 필요):
- 설정 > 휴지통으로 이동합니다
- 복원하려는 항목을 찾습니다
- 복원 버튼(실행 취소 아이콘)을 클릭합니다
항목이 모든 데이터를 그대로 유지한 채 원래 위치로 돌아갑니다.
원래 slug가 이미 사용 중이면 플랫폼은 사용 가능한 고유 slug를 지정해 항목을 복원하므로 즉시 액세스할 수 있습니다.
복원 동작#
| 리소스 | 복원 동작 |
|---|---|
| 프로젝트 | 프로젝트와 프로젝트에 포함된 모든 모델을 복원합니다 |
| 데이터셋 | 데이터 세트의 모든 이미지와 어노테이션을 복원합니다 |
| 모델 | 프로젝트가 활성 상태인 경우 모델을 원래 프로젝트로 복원합니다 |
상위 프로젝트가 휴지통에 있으면 모델을 복원할 수 없습니다. 다음 오류가 표시됩니다. "상위 프로젝트가 휴지통에 있는 동안에는 모델을 복원할 수 없습니다. 먼저 프로젝트를 복원하세요." 개별 모델을 복원하기 전에 항상 상위 프로젝트를 먼저 복원하세요.
영구 삭제#
자동 삭제#
휴지통에 있는 항목은 30일 후 자동으로 영구 삭제됩니다.
휴지통 비우기#
모든 항목을 즉시 영구 삭제하려면 다음을 수행하세요:
- 설정 > 휴지통으로 이동합니다
- 헤더에서 휴지통 아이콘을 클릭합니다
- 작업을 확인합니다
휴지통을 비우면 모든 항목이 즉시 영구 삭제됩니다. 이 작업은 되돌릴 수 없으며, 삭제된 리소스에 연결된 배포, 내보내기 작업, 저장된 파일을 포함한 모든 데이터가 손실됩니다.
단일 항목 영구 삭제#
기다리지 않고 항목 하나를 영구 삭제하려면 다음을 수행하세요:
- 휴지통에서 항목을 찾습니다
- 해당 행에서 영구 삭제(휴지통) 버튼을 클릭합니다
- 삭제를 확인합니다. 대화상자에 항목과 함께 삭제되는 연쇄 모델의 수가 표시됩니다
프로젝트를 영구 삭제하면 삭제된 워크스페이스 리소스에 속한 관련 배포 및 내보내기 파일도 제거됩니다. 배포를 삭제할 수 없으면 Platform에서 경고하고 해당 배포를 프로필의 배포 탭에 계속 표시합니다. 삭제를 다시 시도하려면 해당 배포 페이지를 여세요.
스토리지와 휴지통#
휴지통에 있는 항목도 스토리지 할당량에 포함됩니다:
| 시나리오 | 스토리지 영향 |
|---|---|
| 항목 삭제 | 스토리지가 계속 할당된 상태로 유지됩니다 |
| 항목 복원 | 변경 없음(계속 할당량에 포함됨) |
| 영구 삭제 | 스토리지 확보 |
| 30일 후 자동 삭제 | 스토리지가 자동으로 확보됩니다 |
API 액세스#
REST API를 통해 프로그래밍 방식으로 휴지통에 액세스할 수 있습니다. 세 가지 작업은 모두 동일한 /api/trash 경로에서 제공되며, API 키를 발급한 워크스페이스에서 실행됩니다. 팀 워크스페이스의 휴지통을 관리하려면 해당 워크스페이스의 API 키를 사용하세요. Python 예제에서는 ultralytics-platform SDK를 사용합니다:
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은 all, project, dataset 또는 model를 허용합니다. limit의 기본값은 50이며 최대 200까지 설정할 수 있습니다. 목록을 조회하려면 Viewer 이상의 액세스 권한이 필요합니다.
복원 및 삭제에는 Editor 이상의 액세스 권한이 필요합니다.
자주 묻는 질문#
아니요. 30일이 지나면 항목이 영구 삭제되어 복구할 수 없습니다. 휴지통에 표시된 만료일 전에 중요한 항목을 복원하세요.
프로젝트와 프로젝트 안의 모든 활성 모델이 함께 휴지통으로 이동합니다. 프로젝트를 복원하면 프로젝트와 함께 휴지통으로 이동했던 모델도 복원됩니다. 상위 프로젝트가 계속 휴지통에 있는 동안에는 연쇄 삭제된 모델을 복원할 수 없습니다.
예. 휴지통에 있는 항목도 스토리지 할당량을 계속 사용합니다. 공간을 확보하려면 항목을 영구 삭제하거나 휴지통을 비우세요.
아니요. 프로젝트가 영구 삭제되면 프로젝트 안의 모든 모델도 영구 삭제됩니다. 30일의 기간이 만료되기 전에 항상 항목을 복원하세요.
휴지통의 각 항목에는 자동 영구 삭제까지 남은 일수를 표시하는 "만료" 열이 있습니다(예: "30d").