单目3D初始代码
This commit is contained in:
zhao.zhu
190
docs/en/platform/account/trash.md
Executable file
190
docs/en/platform/account/trash.md
Executable file
@@ -0,0 +1,190 @@
|
||||
---
|
||||
comments: true
|
||||
description: Learn how to recover deleted projects, datasets, and models from Trash on Ultralytics Platform with the 30-day soft delete policy.
|
||||
keywords: Ultralytics Platform, trash, restore, soft delete, recover, deleted items, data recovery
|
||||
---
|
||||
|
||||
# Trash and Restore
|
||||
|
||||
[Ultralytics Platform](https://platform.ultralytics.com) implements a 30-day soft delete policy, allowing you to recover accidentally deleted projects, datasets, and models. Deleted items are moved to Trash where they can be restored before permanent deletion.
|
||||
|
||||
|
||||
|
||||
## Soft Delete Policy
|
||||
|
||||
When you delete a resource on the platform:
|
||||
|
||||
1. **Immediate**: Item moves to Trash (not permanently deleted)
|
||||
2. **30 Days**: Item remains recoverable in Trash
|
||||
3. **After 30 Days**: Item is permanently deleted automatically
|
||||
|
||||
!!! success "Recovery Window"
|
||||
|
||||
You have 30 days to restore any deleted item. After this period, the item and all associated data are permanently removed and cannot be recovered.
|
||||
|
||||
## Accessing Trash
|
||||
|
||||
Navigate to your Trash:
|
||||
|
||||
1. Go to **Settings** and click the **Trash** tab
|
||||
2. Or navigate directly to `/trash` (redirects to `Settings > Trash`)
|
||||
|
||||
|
||||
|
||||
## Trash Contents
|
||||
|
||||
The Trash shows all soft-deleted resources with filter options:
|
||||
|
||||
| Filter | Shows |
|
||||
| ------------ | ----------------- |
|
||||
| **All** | All trashed items |
|
||||
| **Projects** | Trashed projects |
|
||||
| **Datasets** | Trashed datasets |
|
||||
| **Models** | Trashed models |
|
||||
|
||||
### Viewing Trash Items
|
||||
|
||||
Each item in Trash displays:
|
||||
|
||||
| Field | Description |
|
||||
| ------------------ | ---------------------------------------- |
|
||||
| **Name** | Original resource name |
|
||||
| **Type** | Project, Dataset, or Model (color-coded) |
|
||||
| **Deleted** | Date and time of deletion |
|
||||
| **Days Remaining** | Time until permanent deletion |
|
||||
| **Size** | Storage used by the item |
|
||||
| **Cascaded Items** | Number of child items included |
|
||||
| **Parent Project** | Parent project (for models) |
|
||||
|
||||
### Cascade Behavior
|
||||
|
||||
When deleting a parent resource, child resources are also moved to Trash:
|
||||
|
||||
| Resource Type | What's Included When Deleted |
|
||||
| ------------------------------------ | ------------------------------------------ |
|
||||
| [**Projects**](../train/projects.md) | Project + all models inside |
|
||||
| [**Datasets**](../data/datasets.md) | Dataset + all images and annotations |
|
||||
| [**Models**](../train/models.md) | Model weights + training history + exports |
|
||||
|
||||
### Storage Treemap
|
||||
|
||||
The Trash tab includes a storage visualization (treemap) showing the relative size of trashed items, color-coded by type:
|
||||
|
||||
- **Blue**: Projects
|
||||
- **Green**: Datasets
|
||||
- **Purple**: Models
|
||||
|
||||
## Restoring Items
|
||||
|
||||
Recover a deleted item:
|
||||
|
||||
1. Navigate to **Settings > Trash**
|
||||
2. Find the item you want to restore
|
||||
3. Click the **Restore** button (undo icon)
|
||||
4. Confirm restoration
|
||||
|
||||
|
||||
|
||||
The item returns to its original location with all data intact.
|
||||
|
||||
### Restore Behavior
|
||||
|
||||
| Resource | Restore Behavior |
|
||||
| -------- | ----------------------------------------------------------- |
|
||||
| Project | Restores project and all contained models |
|
||||
| Dataset | Restores dataset with all images and annotations |
|
||||
| Model | Restores model to original project if the project is active |
|
||||
|
||||
!!! warning "Parent Project Required"
|
||||
|
||||
Restoring a model fails if its parent project is in Trash. You'll see the error: "Cannot restore model while its parent project is in trash. Restore the project first." Always restore the parent project before restoring individual models.
|
||||
|
||||
## Permanent Deletion
|
||||
|
||||
### Automatic Deletion
|
||||
|
||||
Items in Trash are automatically and permanently deleted after 30 days. A daily cleanup job runs at 3:00 AM UTC to remove expired items.
|
||||
|
||||
### Empty Trash
|
||||
|
||||
Permanently delete all items immediately:
|
||||
|
||||
1. Navigate to **Settings > Trash**
|
||||
2. Click **Empty Trash**
|
||||
3. Confirm the action
|
||||
|
||||
!!! warning "Irreversible Action"
|
||||
|
||||
Emptying Trash permanently deletes all items immediately. This action cannot be undone and all data will be lost.
|
||||
|
||||
### Delete Single Item Permanently
|
||||
|
||||
To permanently delete one item without waiting:
|
||||
|
||||
1. Find the item in Trash
|
||||
2. Click the **Delete** button
|
||||
3. Confirm deletion
|
||||
|
||||
## Storage and Trash
|
||||
|
||||
Items in Trash still count toward your storage quota:
|
||||
|
||||
| Scenario | Storage Impact |
|
||||
| -------------------- | ------------------------------ |
|
||||
| Delete item | Storage remains allocated |
|
||||
| Restore item | No change (was still counting) |
|
||||
| Permanent deletion | Storage freed |
|
||||
| 30-day auto-deletion | Storage freed automatically |
|
||||
|
||||
!!! tip "Free Up Storage"
|
||||
|
||||
If you're running low on storage, empty Trash or permanently delete specific items to immediately reclaim space. Check your storage usage in [Settings](settings.md#storage-usage) and see [Billing](billing.md#plans) for plan storage limits.
|
||||
|
||||
## API Access
|
||||
|
||||
Access trash programmatically via the [REST API](../api/index.md#trash-api):
|
||||
|
||||
=== "List Trash"
|
||||
|
||||
```bash
|
||||
curl -H "Authorization: Bearer YOUR_API_KEY" \
|
||||
https://platform.ultralytics.com/api/trash
|
||||
```
|
||||
|
||||
=== "Restore Item"
|
||||
|
||||
```bash
|
||||
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"id": "item_abc123", "type": "dataset"}' \
|
||||
https://platform.ultralytics.com/api/trash
|
||||
```
|
||||
|
||||
=== "Empty Trash"
|
||||
|
||||
```bash
|
||||
curl -X DELETE -H "Authorization: Bearer YOUR_API_KEY" \
|
||||
https://platform.ultralytics.com/api/trash/empty
|
||||
```
|
||||
|
||||
## FAQ
|
||||
|
||||
### Can I restore an item after 30 days?
|
||||
|
||||
No. After 30 days, items are permanently deleted and cannot be recovered. Make sure to restore important items before the expiration date shown in Trash.
|
||||
|
||||
### What happens when I delete a project with models?
|
||||
|
||||
Both the project and all models inside it move to Trash together. Restoring the project restores all its models. You can also restore individual models separately.
|
||||
|
||||
### Do items in Trash count toward storage?
|
||||
|
||||
Yes, items in Trash continue to use storage quota. To free up space, permanently delete items or empty Trash.
|
||||
|
||||
### Can I recover a model if its project was permanently deleted?
|
||||
|
||||
No. If a project is permanently deleted, all models that were inside it are also permanently deleted. Always restore items before the 30-day window expires.
|
||||
|
||||
### How do I know when an item will be permanently deleted?
|
||||
|
||||
Each item in Trash shows a "Days Remaining" counter indicating how many days until automatic permanent deletion occurs.
|
||||
Reference in New Issue
Block a user