ごみ箱と復元#
Ultralytics Platformでは、30日間のソフトデリートポリシーを採用しており、誤って削除したプロジェクト、データセット、モデルを復元できます。削除されたアイテムはゴミ箱に移動され、完全に削除される前であれば復元できます。
ソフトデリートポリシー#
プラットフォーム上でリソースを削除すると、次のようになります。
- 直後: アイテムがゴミ箱に移動します（完全には削除されません）
- 30日間: アイテムはゴミ箱から復元できます
- 30日後: アイテムは自動的に完全削除されます
削除したアイテムは30日以内であれば復元できます。この期間を過ぎると、アイテムと関連するすべてのデータが完全に削除され、復元できなくなります。
ゴミ箱へのアクセス#
ゴミ箱に移動するには、次の操作を行います。
- Settingsに移動し、Trashタブをクリックします
- または、
/trashに直接移動します（Settings > Trashにリダイレクトされます）
ゴミ箱の内容#
ゴミ箱には、ソフトデリートされたすべてのリソースが表示されます。各フィルタータブには現在の件数が表示され、名前とタイプに一致する検索ボックスも利用できます。
| フィルター | 表示対象 |
|---|---|
| すべて | ゴミ箱内のすべてのアイテム |
| データセット | ゴミ箱内のデータセット |
| プロジェクト | ゴミ箱内のプロジェクト |
| モデル | ゴミ箱内のモデル |
ゴミ箱内のアイテムの表示#
ゴミ箱内の各アイテムには、次の情報が表示されます。
| 項目 | 説明 |
|---|---|
| 名前 | 元のリソース名 |
| 入力 | プロジェクト、データセット、またはモデル（タイプごとに色分け） |
| 削除日時 | アイテムが削除されてからの経過時間 |
| 有効期限 | 完全削除までの日数（例: "30d"）。15日未満はアンバー、8日未満は赤で表示されます |
| サイズ | アイテムが使用しているストレージ容量 |
| カスケード | 子アイテムが含まれている場合、名前の横に+Nバッジとして表示されます |
（親プロジェクトの情報はモデル向けのTrash APIから返されますが、ゴミ箱のテーブルには表示されません。）
カスケード動作#
親リソースを削除すると、子リソースもゴミ箱に移動されます。
| リソースタイプ | 削除時に含まれるもの |
|---|---|
| プロジェクト | プロジェクトとその中にあるすべてのモデル |
| データセット | データセットとすべての画像およびアノテーション |
| モデル | モデルの重み、トレーニング履歴、エクスポートデータ |
モデル、またはモデルを含むプロジェクトをゴミ箱に移動すると、そのモデルで進行中のクラウドトレーニングがキャンセルされ、GPUインスタンスが終了します。経過したGPU時間については引き続き課金されます。Billingを参照してください。
ストレージのツリーマップ#
ゴミ箱タブには、ゴミ箱内のアイテムの相対的なサイズを示すストレージの可視化（ツリーマップ）が含まれています。タイプごとに色分けされています。
- 青: プロジェクト
- 緑: データセット
- 紫: モデル
アイテムの復元#
削除したアイテムを復元するには、チームワークスペースでEditorロール以上が必要です。
- Settings > Trashに移動します
- 復元するアイテムを見つけます
- Restoreボタン（元に戻すアイコン）をクリックします
アイテムはすべてのデータを保持したまま、元の場所に戻ります。
元のスラッグがすでに使用されている場合、プラットフォームは利用可能な一意のスラッグでアイテムを復元するため、すぐにアクセスできます。
復元の動作#
| リソース | 復元の動作 |
|---|---|
| プロジェクト | プロジェクトとその中に含まれるすべてのモデルを復元します |
| データセット | すべての画像とアノテーションを含むデータセットを復元します |
| モデル | プロジェクトがアクティブな場合、モデルを元のプロジェクトに復元します |
親プロジェクトがゴミ箱にある場合、モデルの復元は失敗します。次のエラーが表示されます: "Cannot restore model while its parent project is in trash. Restore the project first." 個々のモデルを復元する前に、必ず親プロジェクトを復元してください。
完全削除#
自動削除#
ゴミ箱内のアイテムは、30日後に自動的かつ完全に削除されます。
ゴミ箱を空にする#
すべてのアイテムを直ちに完全削除するには、次の操作を行います。
- Settings > Trashに移動します
- ヘッダーのゴミ箱アイコンをクリックします
- 操作を確認します
ゴミ箱を空にすると、すべてのアイテムが直ちに完全削除されます。この操作は取り消せず、関連付けられたデプロイ、エクスポートジョブ、ゴミ箱内のリソースに紐付く保存ファイルなど、すべてのデータが失われます。
単一アイテムの完全削除#
待機せずに1つのアイテムを完全削除するには、次の操作を行います。
- ゴミ箱でアイテムを見つけます
- その行にある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日間の期間が終了する前に、必ずアイテムを復元してください。
ごみ箱内の各アイテムには、自動的に完全削除されるまでの日数（例：「30d」）を示す「Expires」列が表示されます。