> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.
> Définissez des politiques de durée de vie (TTL) pour les artifacts W&B afin de planifier leur suppression automatique et de maîtriser votre consommation de stockage.
# Gérer la rétention des données des artifacts
export const ColabLink = ({url}) =>
Try in Colab
;
Planifiez la suppression des artifacts de W\&B à l’aide d’une politique TTL (time-to-live, durée de vie) d’artifact W\&B. Lorsque vous supprimez un artifact, W\&B le marque comme *soft-delete* (suppression logique). Autrement dit, l’artifact est marqué pour suppression, mais ses fichiers ne sont pas immédiatement supprimés du stockage. Pour plus d’informations sur la façon dont W\&B supprime les artifacts, consultez la page [Supprimer des artifacts](/fr/products/wandb/artifacts/delete-artifacts).
Regardez le tutoriel vidéo [Managing data retention with Artifacts TTL](https://www.youtube.com/watch?v=hQ9J6BoVmnc) pour apprendre à gérer la rétention des données avec Artifacts TTL dans la W\&B App.
* Seuls les administrateurs d’équipe peuvent consulter les [paramètres d’une équipe](/fr/products/wandb/platform/app/settings-page/teams) et accéder aux paramètres TTL au niveau de l’équipe, par exemple pour (1) définir qui est autorisé à configurer ou modifier une politique TTL ou (2) définir une TTL par défaut pour l’équipe.
* Si l’option permettant de définir ou de modifier une politique TTL n’apparaît pas dans les détails d’un artifact dans l’interface de la W\&B App, ou si la définition d’une TTL par programmation ne modifie pas la propriété TTL d’un artifact, cela signifie que votre administrateur d’équipe ne vous a pas accordé les autorisations nécessaires.
Artifacts générés automatiquement
Seuls les artifacts générés par les utilisateurs peuvent faire l’objet d’une politique TTL. Il est impossible de définir une politique TTL pour les artifacts générés automatiquement par W\&B.
Les types d’artifacts suivants signalent un artifact généré automatiquement :
* `run_table`
* `code`
* `job`
* Tout type d’artifact commençant par : `wandb-*`
Vous pouvez vérifier le type d’un artifact sur la [plateforme W\&B](/fr/products/wandb/artifacts/explore-and-traverse-an-artifact-graph) ou par programmation :
```python theme={"system"}
import wandb
with wandb.init(project="") as run:
artifact = run.use_artifact(artifact_or_name="")
print(artifact.type)
```
Remplacez les valeurs entre `<>` par les vôtres.
Définir qui peut modifier et configurer les politiques TTL
Définissez qui peut configurer et modifier les politiques TTL au sein d’une équipe. Vous pouvez réserver les autorisations TTL aux administrateurs d’équipe, ou bien les accorder à la fois aux administrateurs d’équipe et aux membres de l’équipe.
Seuls les administrateurs d’équipe peuvent définir qui peut configurer ou modifier une politique TTL.
1. Accédez à la page de profil de votre équipe.
2. Sélectionnez l’onglet **Paramètres**.
3. Accédez à la section **Artifacts time-to-live (TTL) section**.
4. Dans le menu déroulant **TTL permissions dropdown**, indiquez qui peut configurer et modifier les politiques TTL.
5. Cliquez sur **Vérifier et enregistrer les paramètres**.
6. Confirmez les modifications et sélectionnez **Enregistrer les paramètres**.
Créer une politique TTL
Définissez une politique TTL pour un artifact soit lors de sa création, soit rétroactivement, une fois l’artifact créé.
Pour utiliser les extraits de code ci-dessous, remplacez le contenu entre `<>` par vos propres informations.
Définir une politique TTL lors de la création d’un artifact
Utilisez le SDK Python W\&B pour définir une politique TTL lors de la création d’un artifact. Les politiques TTL sont généralement exprimées en jours.
Définir une politique TTL lors de la création d’un artifact revient à [créer un artifact](/fr/products/wandb/artifacts/construct-an-artifact) de la manière habituelle, à ceci près que vous transmettez un delta temporel à l’attribut `ttl` de l’artifact.
Procédez comme suit :
1. [Créez un artifact](/fr/products/wandb/artifacts/construct-an-artifact).
2. [Ajoutez du contenu à l’artifact](/fr/products/wandb/artifacts/construct-an-artifact#add-files-to-an-artifact), par exemple des fichiers, un répertoire ou une référence.
3. Définissez une durée limite TTL à l’aide du type de données [`datetime.timedelta`](https://docs.python.org/3/library/datetime.html) de la bibliothèque standard de Python.
4. [Journalisez l’artifact](/fr/products/wandb/artifacts/construct-an-artifact#3-save-your-artifact-to-the-wb-server).
L’extrait de code suivant montre comment créer un artifact et définir une politique TTL.
```python theme={"system"}
import wandb
from datetime import timedelta
with wandb.init(project="", entity="") as run:
artifact = wandb.Artifact(name="", type="")
artifact.add_file("")
artifact.ttl = timedelta(days=30) # Définir la politique TTL
run.log_artifact(artifact)
```
L’extrait de code ci-dessus définit une politique TTL de 30 jours pour l’artifact. Autrement dit, W\&B supprime l’artifact au bout de 30 jours.
Définir ou modifier une politique TTL après la création d’un artifact
Utilisez l’interface de l’application W\&B ou le SDK Python W\&B pour définir une politique TTL sur un artifact existant.
Lorsque vous modifiez la TTL d’un artifact, son délai d’expiration reste calculé à partir de son horodatage `createdAt`.
1. [Récupérez votre artifact](/fr/products/wandb/artifacts/download-and-use-an-artifact).
2. Affectez une durée (`timedelta`) à l’attribut `ttl` de l’artifact.
3. Mettez à jour l’artifact avec la méthode [`save`](/fr/products/wandb/ref/python/experiments/run#save).
L’extrait de code suivant montre comment définir une politique TTL pour un artifact :
```python theme={"system"}
import wandb
from datetime import timedelta
artifact = run.use_artifact("")
artifact.ttl = timedelta(days=365 * 2) # Supprimer dans deux ans
artifact.save()
```
L’exemple de code ci-dessus fixe la politique TTL à deux ans.
1. Accédez à votre projet W\&B dans l’interface de l’application W\&B.
2. Sélectionnez l’icône des artifacts dans la barre latérale du projet.
3. Dans la liste des artifacts, développez le type d’artifact que vous
4. Sélectionnez la version de l’artifact dont vous souhaitez modifier la politique TTL.
5. Cliquez sur l’onglet **Version**.
6. Dans la liste déroulante, sélectionnez **Edit TTL policy**.
7. Dans la fenêtre modale qui s’affiche, sélectionnez **Custom** dans la liste déroulante de la politique TTL.
8. Dans le champ **TTL duration**, indiquez la durée de la politique TTL en jours.
9. Sélectionnez le bouton **Update TTL** pour enregistrer vos modifications.
Définir des politiques TTL par défaut pour une équipe
Seuls les administrateurs d’équipe peuvent définir une politique TTL par défaut pour une équipe.
Définissez une politique TTL par défaut pour votre équipe. Les politiques TTL par défaut s’appliquent à tous les artifacts existants et futurs, en fonction de leur date de création respective. Les artifacts qui disposent déjà d’une politique TTL au niveau de la version ne sont pas concernés par la politique TTL par défaut de l’équipe.
1. Accédez à la page de profil de votre équipe.
2. Sélectionnez l’onglet **Settings**.
3. Accédez à la section **Artifacts time-to-live (TTL) section**.
4. Cliquez sur **Set team's default TTL policy**.
5. Dans le champ **Duration**, définissez la politique TTL en nombre de jours.
6. Cliquez sur **vérifier et enregistrer les paramètres**.
7/ Confirmez les modifications, puis sélectionnez **enregistrer les paramètres**.
Définir une politique TTL en dehors d’un run
Utilisez l’API publique pour récupérer un artifact sans passer par un run, puis définissez sa politique TTL. Les politiques TTL sont généralement exprimées en jours.
L’exemple de code suivant montre comment récupérer un artifact à l’aide de l’API publique et définir sa politique TTL.
```python theme={"system"}
api = wandb.Api()
artifact = api.artifact("entity/project/artifact:alias")
artifact.ttl = timedelta(days=365) # Suppression dans un an
artifact.save()
```
Désactiver une politique TTL
Utilisez le SDK Python W\&B ou l’interface de l’application W\&B pour désactiver la politique TTL d’une version spécifique d’un artifact.
1. [Récupérez votre artifact](/fr/products/wandb/artifacts/download-and-use-an-artifact).
2. Définissez l’attribut `ttl` de l’artifact sur `None`.
3. Mettez à jour l’artifact à l’aide de la méthode [`save`](/fr/products/wandb/ref/python/experiments/run#save).
L’extrait de code suivant montre comment désactiver la politique TTL d’un artifact :
```python theme={"system"}
artifact = run.use_artifact("")
artifact.ttl = None
artifact.save()
```
1. Accédez à votre projet W\&B dans l’interface de l’application W\&B.
2. Sélectionnez l’icône des artifacts dans la barre latérale du projet.
3. Dans la liste des artifacts, développez le type d’artifact que vous
4. Sélectionnez la version de l’artifact dont vous souhaitez modifier la politique TTL.
5. Cliquez sur l’onglet Version.
6. Cliquez sur le menu **action ()** à côté du bouton **Link to registry**.
7. Dans la liste déroulante, sélectionnez **Edit TTL policy**.
8. Dans la fenêtre modale qui s’affiche, sélectionnez **Deactivate** dans la liste déroulante de la politique TTL.
9. Cliquez sur le bouton **Update TTL** pour enregistrer vos modifications.
Afficher les politiques TTL
Affichez les politiques TTL des artifacts avec le SDK Python ou avec l’interface de l’application W\&B.
Utilisez une instruction print pour afficher la politique TTL d’un artifact. L’exemple suivant montre comment récupérer un artifact et afficher sa politique TTL :
```python theme={"system"}
artifact = run.use_artifact("")
print(artifact.ttl)
```
Affichez la politique TTL d’un artifact avec l’interface de l’application W\&B.
1. Accédez à la [W\&B App](https://forge.coreweave.com/wandb).
2. Accédez à votre projet W\&B.
3. Dans votre projet, sélectionnez l’onglet Artifacts dans la barre latérale du projet.
4. Cliquez sur une collection.
La vue de la collection affiche tous les artifacts de la collection sélectionnée. La colonne `Time to Live` indique la politique TTL attribuée à chaque artifact.
Politiques TTL pour les versions d’artifact liées
W\&B désactive les politiques TTL des versions d’artifact liées afin d’éviter que les artifacts utilisés dans des flux de travail de production n’expirent.
Lorsque vous liez une version d’artifact à une collection du registre, W\&B désactive sa politique TTL et définit son TTL sur `None`. Si vous dissociez ensuite la version d’artifact, W\&B ne rétablit ni la politique TTL précédente ni sa durée. Si la version d’artifact en a toujours besoin, définissez une nouvelle politique TTL après la dissociation.
