Skip to main content
W&B Artifact の有効期限 (TTL) ポリシーを使用すると、W&B からアーティファクトを削除するタイミングをスケジュールできます。アーティファクトを削除すると、W&B はそのアーティファクトを論理削除としてマークします。つまり、アーティファクトは削除対象としてマークされますが、ファイルはストレージからすぐには削除されません。W&B がアーティファクトを削除する仕組みの詳細については、アーティファクトを削除するページを参照してください。 W&B App で Artifacts TTL を使用してデータ保持を管理する方法については、動画チュートリアル Managing data retention with Artifacts TTL をご覧ください。
  • チームの設定を表示し、チームレベルの TTL 設定 ((1) TTL ポリシーを設定・編集できるユーザーの指定、(2) チームのデフォルト TTL の設定など) にアクセスできるのは、チーム管理者のみです。
  • W&B App UI のアーティファクトの詳細に TTL ポリシーを設定・編集するオプションが表示されない場合や、プログラムで TTL を設定してもアーティファクトの TTL プロパティが変更されない場合は、チーム管理者からその操作の権限が付与されていません。

自動生成されたアーティファクト

TTL ポリシーを使用できるのは、ユーザーが生成したアーティファクトのみです。W&B によって自動生成されたアーティファクトには、TTL ポリシーを設定できません。 次のアーティファクト タイプは、自動生成されたアーティファクトであることを示します。
  • run_table
  • code
  • job
  • wandb-* で始まるすべてのアーティファクト タイプ
アーティファクトのタイプは、W&B プラットフォーム上で確認するか、次のようにプログラムで確認できます。
<> で囲まれた値を、ご自身の値に置き換えてください。

TTL ポリシーを編集・設定できるユーザーを定義する

チーム内で TTL ポリシーを設定・編集できるユーザーを定義します。TTL の権限は、チーム管理者のみに付与することも、チーム管理者とチームメンバーの両方に付与することもできます。
TTL ポリシーを設定・編集できるユーザーを定義できるのは、チーム管理者のみです。
  1. チームのプロフィールページにアクセスします。
  2. Settings タブを選択します。
  3. Artifacts time-to-live (TTL) section にアクセスします。
  4. TTL permissions dropdown から、TTL ポリシーを設定・編集できるユーザーを選択します。
  5. Review and save settings をクリックします。
  6. 変更内容を確認し、Save settings を選択します。
TTL 権限の設定

TTL ポリシーを作成する

アーティファクトの TTL ポリシーは、アーティファクトの作成時、または作成後に遡って設定できます。 以下のすべてのコードスニペットを使用する際は、<> で囲まれた内容を実際の情報に置き換えてください。

アーティファクトの作成時に TTL ポリシーを設定する

W&B Python SDK を使用して、アーティファクトの作成時に TTL ポリシーを定義します。TTL ポリシーは通常、日単位で定義します。
アーティファクトの作成時に TTL ポリシーを定義する方法は、通常のアーティファクトの作成と似ています。ただし、アーティファクトの ttl 属性に時間差分を渡す点が異なります。
手順は次のとおりです。
  1. アーティファクトを作成します。
  2. ファイル、ディレクトリ、参照などのコンテンツをアーティファクトに追加します。
  3. Python の標準ライブラリに含まれる datetime.timedelta データタイプを使用して、TTL の時間制限を定義します。
  4. アーティファクトをログします。
次のコードスニペットは、アーティファクトを作成して TTL ポリシーを設定する方法を示しています。
上記のコードスニペットでは、アーティファクトの TTL ポリシーを30日に設定しています。つまり、W&B は30日後にアーティファクトを削除します。

アーティファクトの作成後に TTL ポリシーを設定または編集する

W&B App UI または W&B Python SDK を使用して、既存のアーティファクトに TTL ポリシーを定義します。
アーティファクトの TTL を変更しても、有効期限までの時間は引き続きアーティファクトの createdAt タイムスタンプを基準に計算されます。
  1. アーティファクトを取得します。
  2. アーティファクトの ttl 属性に時間差分 (timedelta) を渡します。
  3. save メソッドでアーティファクトを更新します。
次のコードスニペットは、アーティファクトに TTL ポリシーを設定する方法を示しています。
上記のコード例では、TTL ポリシーを 2 年に設定しています。

チームのデフォルト TTL ポリシーを設定する

チームのデフォルト TTL ポリシーを設定できるのは、チーム管理者のみです。
チームのデフォルト TTL ポリシーを設定します。デフォルト TTL ポリシーは、それぞれの作成日に基づいて、既存および今後作成されるすべてのアーティファクトに適用されます。バージョン単位の TTL ポリシーがすでに設定されているアーティファクトは、チームのデフォルト TTL の影響を受けません。
  1. チームのプロフィールページにアクセスします。
  2. Settings タブを選択します。
  3. Artifacts time-to-live (TTL) section にアクセスします。
  4. Set team’s default TTL policy をクリックします。
  5. Duration フィールドで、TTL ポリシーを日単位で設定します。
  6. Review and save settings をクリックします。 7/ 変更を確認し、Save settings を選択します。
デフォルト TTL ポリシーの設定

run の外部で TTL ポリシーを設定する

Public API を使用して、run を取得せずにアーティファクトを取得し、TTL ポリシーを設定します。TTL ポリシーは通常、日単位で定義します。 次のコードサンプルでは、Public API を使用してアーティファクトを取得し、TTL ポリシーを設定する方法を示します。

TTL ポリシーを無効化する

W&B Python SDK または W&B アプリ UI を使用して、特定のアーティファクトのバージョンの TTL ポリシーを無効化します。
  1. アーティファクトを取得します。
  2. アーティファクトの ttl 属性を None に設定します。
  3. save メソッドでアーティファクトを更新します。
次のコードスニペットは、アーティファクトの TTL ポリシーを無効にする方法を示しています。

TTL ポリシーの確認

Python SDK または W&B App UI でアーティファクトの TTL ポリシーを確認します。
print 文を使用してアーティファクトの TTL ポリシーを確認します。次の例では、アーティファクトを取得し、その TTL ポリシーを確認する方法を示します。

リンクされたアーティファクトのバージョンの TTL ポリシー

W&B は、本番ワークフローで使用されているアーティファクトが期限切れにならないように、リンクされたアーティファクトのバージョンの TTL ポリシーを無効化します。 アーティファクトのバージョンを Registry コレクションにリンクすると、W&B はその TTL ポリシーを無効化し、TTL を None に設定します。後でアーティファクトのバージョンのリンクを解除しても、以前の TTL ポリシーやその期間は復元されません。リンク解除後もアーティファクトのバージョンに TTL ポリシーが必要な場合は、新しい TTL ポリシーを設定してください。
最終更新日 2026年9月30日