> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# バケットストレージとコストを管理する

> W&B がオブジェクトストレージをどのように使用するか、削除がバケット使用量（バイト数）にどのように反映されるか、またストレージの使用量とコストを削減する方法を理解します。

[Bring your own bucket を使用する (BYOB)](/ja/platform/hosting/data-security/secure-storage-connector)、[W\&B Dedicated Cloud](/ja/platform/hosting/hosting-options/dedicated-cloud)、または [W\&B Self-Managed](/ja/platform/hosting/hosting-options/self-managed) を使用する場合、通常、チームでクラウドストレージプロバイダに直接料金を支払うことになります。このページでは、バケット内で容量を消費するもの、アプリまたは API で削除した後に W\&B がオブジェクトをどのように削除するか、そして何を想定すべきかについて説明します。これを活用して、バケットの使用状況を把握し、クリーンアップを計画し、ストレージが再利用可能になる時期について現実的な見通しを立ててください。

このページは、セルフマネージド、専用クラウド、または BYOB のデプロイ環境でオブジェクトストレージを管理する W\&B 管理者およびオペレーターを対象としています。

<div id="what-uses-bucket-space">
  ## バケット容量を消費するもの
</div>

W\&B は、設定したオブジェクトストレージに複数の種類のデータを保存します。[BYOB overview](/ja/platform/hosting/data-security/secure-storage-connector#data-stored-in-the-central-database-vs-buckets) には、実験ファイルとメトリクス、artifact ファイル、メディアファイル、run ファイル、Parquet 形式でエクスポートされた履歴などの例が記載されています。これらの合計が、バケットのサイズとコストに影響します。

<div id="how-wb-removes-data-from-storage">
  ## W\&B がストレージからデータを削除する仕組み
</div>

W\&B App または [Public API](/ja/models/ref/python/public-api/api) で削除を行うと、まず W\&B のメタデータが更新されます。プロダクトから run、アーティファクト、またはファイルを削除しても、表示されるバケット使用量がすぐに減るとは限りません。オブジェクトストレージのクリーンアップはバックグラウンドで実行されるため、特に高負荷のインスタンスでは反映が遅れることがあります。

<div id="artifacts">
  ### Artifacts
</div>

削除されたアーティファクトはソフト削除された後、アーティファクト のガベージコレクションによって処理されます。セルフマネージドのデプロイでは、`GORILLA_ARTIFACT_GC_ENABLED` を設定し、バージョン管理やソフト削除などのプロバイダの要件を満たす必要があります。[アーティファクトを削除する](/ja/models/artifacts/delete-artifacts)および[環境変数を設定する](/ja/platform/hosting/env-vars)を参照してください。

<div id="run-data-and-run-files">
  ### runデータとrunファイル
</div>

runまたはrunに関連付けられたファイルが削除された後、基盤となる保存オブジェクトの完全な削除は、アーティファクト とは別に制御されます。専用クラウドおよびセルフマネージドのデプロイでは、`GORILLA_DATA_RETENTION_PERIOD` で、削除されたrunデータがストレージから削除可能になるまで保持される期間を設定します。この設定で アーティファクト が削除されることはありません。runおよびファイルの削除とストレージとの関係については、[環境変数を設定する](/ja/platform/hosting/env-vars)、専用クラウド向けの [データ保持ポリシー](/ja/platform/hosting/hosting-options/dedicated-cloud#data-retention-policy)、および [ランを削除する](/ja/models/runs/delete-runs#when-deleted-run-data-is-removed-from-storage) を参照してください。

<div id="what-to-expect-from-background-cleanup">
  ## バックグラウンド クリーンアップで想定されること
</div>

オブジェクトストレージを解放するガベージコレクションと関連ジョブの実行タイミングは保証されません。W\&B は、UI または API でコンテンツを削除したあと、特定の時間内に対象のオブジェクトがバケットから消えることを**保証しません**。1 つのrunあたりのファイル数が多いプロジェクト、たとえば 1 つのrunで多数のメディアファイルをログしている場合は、ストレージ使用量が解放されるまでに**より長い遅延**が発生することがあります。

クラウドプロバイダ側でバケットを監視し、クリーンアップが滞っているように見える場合は、[W\&B Support](mailto:support@wandb.ai) または担当のアカウントチームにお問い合わせください。

<div id="reduce-bucket-usage">
  ## バケット使用量を減らす
</div>

このセクションでは、バケットの空き容量を増やすための推奨される操作順序について説明します。安全なプロダクトの機能から始めて、より注意が必要なバケットの直接操作へと進みます。

まずは、サポートされているプロダクトの機能で対応してください。

* 不要になったrunは、[W\&B App で削除する](/ja/models/runs/delete-runs#ui) か、[Python で削除する](/ja/models/runs/delete-runs#python) ようにしてください。
* 不要になった[アーティファクトを削除し](/ja/models/artifacts/delete-artifacts)、ワークフローに合う場合は [アーティファクト TTL](/ja/models/artifacts/ttl) を使用してください。

すぐに容量を回収する必要がある場合は、バケットにアクセスできるオペレーターが、クラウド ストレージ内の特定のオブジェクト キーを直接削除できます。

:::caution
バケット内のオブジェクト キーを直接削除すると、W\&B を介さずに処理されるため、データ損失が発生したり、アプリからアクセスできなくなったりする可能性があります。続行する前に、次の点を確認してください。

* 削除したオブジェクトは、W\&B 経由で**ダウンロードできなくなります**。
* 削除するつもりのキー**だけ**を削除してください。誤って削除すると、アプリがまだ参照しているデータにアクセスできなくなる可能性があります。
* バケットで**オブジェクトのバージョン管理**または**プロバイダのソフト削除** (たとえば Google Cloud Storage) を使用している場合、クラウドのライフサイクル ルールに従って非カレント バージョンやソフト削除されたオブジェクトの有効期限が切れるまで、ストレージ料金が発生し続けることがあります。
  :::

W\&B Multi-tenant Cloud での大まかな使用状況は、組織管理者が組織の設定からストレージ関連の使用状況を確認できます。詳しくは [Billing settings](/ja/platform/app/settings-page/billing-settings) を参照してください。

<div id="troubleshooting">
  ## トラブルシューティング
</div>

Public API を使用した後に W\&B App で削除が正しく反映されない場合は、W\&B Python SDK を最新のリリースにアップグレードしてから、再試行してください。各 run のファイル数が多い場合、インスタンス全体でバックグラウンド クリーンアップにかかる時間が長くなることがあります。

お使いのデプロイメントに合ったスクリプトによるクリーンアップ パターンについては、[W\&B Support](mailto:support@wandb.ai) または担当のアカウントチームにお問い合わせください。

<div id="related-documentation">
  ## 関連ドキュメント
</div>

詳細は、以下のリソースを参照してください。

* [run を削除する](/ja/models/runs/delete-runs#delete-runs)
* [アーティファクトを削除する](/ja/models/artifacts/delete-artifacts)
* [環境変数を設定する](/ja/platform/hosting/env-vars)
* [Bring your own bucket を使用する](/ja/platform/hosting/data-security/secure-storage-connector)