ゴミ箱と復元#
Ultralytics Platformは30日間の論理削除ポリシーを実装しており、誤って削除したプロジェクト、データセット、モデルを復元できます。削除されたアイテムはゴミ箱に移動され、完全に削除される前に復元できます。
ソフトデリートポリシー#
プラットフォーム上でリソースを削除すると、以下のようになります。
- 即時: アイテムはゴミ箱に移動します（完全には削除されません）
- 30日間: アイテムはゴミ箱内で復元可能な状態を保持します
- 30日後: アイテムは自動的に完全に削除されます
削除されたアイテムは30日以内であれば復元できます。この期間を過ぎると、アイテムおよび関連するすべてのデータは完全に削除され、復元できなくなります。
ゴミ箱へのアクセス#
ゴミ箱へ移動する方法：
- Settings（設定）に移動し、Trash（ゴミ箱）タブをクリックします。
- または、
/trashに直接移動します（Settings > Trashにリダイレクトされます）
ゴミ箱の内容#
ごみ箱には、ライブカウントを示すフィルタータブ付きのすべての論理削除済みリソースと、名前およびタイプに一致する検索ボックスが表示されます。
| フィルタ | 表示内容 |
|---|---|
| All | ゴミ箱内のすべてのアイテム |
| データセット | ゴミ箱内のデータセット |
| プロジェクト | ゴミ箱内のプロジェクト |
| モデル数 | ゴミ箱内のモデル |
ゴミ箱内のアイテムの表示#
ゴミ箱内の各アイテムには、以下が表示されます。
| フィールド | 説明 |
|---|---|
| 名前 | 元のリソース名 |
| Type（入力） | プロジェクト、データセット、またはモデル（色分け） |
| Deleted（削除日時） | アイテムが削除されてからの経過時間 |
| Expires（有効期限） | 完全削除までの日数（例: "30d"）、15日未満の場合は黄色、8日未満の場合は赤色 |
| Size | アイテムが使用しているストレージ容量 |
| Cascaded（カスケード削除） | 子アイテムが含まれており、名前の横に+Nバッジとして表示されます |
（親プロジェクトの情報はモデルのTrash APIで返されますが、ゴミ箱のテーブルには表示されません。）
カスケード動作#
親リソースを削除すると、子リソースもゴミ箱に移動します。
| リソースタイプ | 削除時に含まれるもの |
|---|---|
| Projects | プロジェクトと、その中のすべてのモデル |
| Datasets | データセットと、すべての画像およびアノテーション |
| Models | モデルのウェイト、学習履歴、エクスポートデータ |
モデル（またはモデルを含むプロジェクト）をごみ箱に移動すると、そのモデルで進行中のクラウドトレーニングがすべてキャンセルされ、GPUインスタンスが終了します。経過したGPU時間は引き続き請求されます。Billingを参照してください。
ストレージツリーマップ#
ゴミ箱タブには、ゴミ箱内のアイテムの相対的なサイズを示すストレージの可視化（ツリーマップ）が含まれており、タイプ別に色分けされています。
- 青: プロジェクト
- 緑: データセット
- 紫: モデル
アイテムの復元#
削除されたアイテムを復元する（チームワークスペースのエディターロール以上が必要）：
- Settings > Trash に移動します
- 復元したいアイテムを見つけます
- Restore（復元）ボタン（元に戻すアイコン）をクリックします
アイテムはすべてのデータを維持したまま元の場所に復元されます。
元のスラッグが既に使用されている場合、プラットフォームは利用可能な別のユニークなスラッグでアイテムを復元するため、すぐにアクセス可能です。
復元動作#
| リソース | 復元動作 |
|---|---|
| プロジェクト | プロジェクトとその中の全モデルを復元します |
| データセット | データセットと、すべての画像およびアノテーションを復元します |
| モデル | プロジェクトがアクティブな場合、モデルを元のプロジェクトに復元します |
モデルの復元は、その親プロジェクトがゴミ箱にあると失敗します。その場合、「Cannot restore model while its parent project is in trash. Restore the project first.」（親プロジェクトがゴミ箱にある間はモデルを復元できません。先にプロジェクトを復元してください。）というエラーが表示されます。個別のモデルを復元する前に、必ず親プロジェクトを復元してください。
完全削除#
自動削除#
ごみ箱内のアイテムは、30日後に自動的に完全削除されます。
ゴミ箱を空にする#
すべてのアイテムを直ちに完全に削除する手順：
- Settings > Trash に移動します
- ヘッダーのごみ箱アイコンをクリックします
- 操作を確定します
ゴミ箱を空にすると、すべてのアイテムが直ちに完全に削除されます。この操作は取り消すことができず、関連するデプロイメント、エクスポートジョブ、およびゴミ箱内のリソースに関連付けられた保存済みファイルを含むすべてのデータが失われます。
単一アイテムの完全削除#
待たずに特定のアイテムを完全に削除する場合：
- ゴミ箱内でアイテムを探します
- 該当する行の Delete permanently （ごみ箱）ボタンをクリックします
- 削除を確認します。ダイアログにはアイテム名と、連鎖して削除されるモデルの数が表示されます
プロジェクトの場合、完全削除を行うと、削除されたワークスペースリソースに属する関連デプロイメントやエクスポートファイルも削除されます。デプロイメントを削除できない場合、Platformが警告を表示し、Deploymentsページにリストに残すため、そこから再試行できます。
ストレージとゴミ箱#
ゴミ箱内のアイテムも、ストレージ容量としてカウントされます。
| シナリオ | ストレージへの影響 |
|---|---|
| アイテムを削除 | ストレージ使用量に含まれたまま |
| アイテムを復元 | 変化なし（カウントされたまま） |
| 完全削除 | ストレージが解放される |
| 30日後の自動削除 | ストレージが自動的に解放される |
APIアクセス#
REST API経由でゴミ箱にプログラムからアクセスします。3つの操作はいずれも同じ /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アクセス以上が必要です。
よくある質問 (FAQ)#
いいえ。30日を過ぎると、アイテムは完全に削除され、復元できません。ゴミ箱に表示される有効期限までに重要なアイテムを必ず復元してください。
プロジェクトとそこに含まれるすべての有効なモデルは、一緒にゴミ箱へ移動します。プロジェクトを復元すると、一緒にゴミ箱へ移動されたモデルも復元されます。親プロジェクトがゴミ箱に残っている間は、カスケードされたモデルを復元することはできません。
はい。ゴミ箱内のアイテムは引き続きストレージ容量を消費します。空き容量を確保するには、アイテムを完全に削除するか、ゴミ箱を空にしてください。
いいえ。プロジェクトが完全に削除されると、その中にあったすべてのモデルも完全に削除されます。30日間の期間が切れる前に、必ずアイテムを復元してください。
ゴミ箱内の各アイテムには、「Expires」（有効期限）列があり、自動的な完全削除までの残り日数が表示されます（例: 「30d」）。