> ## 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.

> Définissez des stratégies de durée de vie (TTL) sur les Artifacts W&B afin de planifier leur suppression automatique et de gérer la consommation de stockage.

# Gérer la rétention des données des Artifacts

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Essayer sur Colab
  </a>;

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/kas-artifacts-ttl-colab/colabs/wandb-artifacts/WandB_Artifacts_Time_to_live_TTL_Walkthrough.ipynb" />

Planifiez le moment où les artifacts sont supprimés de W\&B à l’aide d’une politique de durée de vie (TTL) des Artifacts W\&B. Lorsque vous supprimez un artifact, W\&B marque cet artifact comme une *suppression logique*. En d’autres termes, l’artifact est marqué pour suppression, mais les fichiers ne sont pas immédiatement supprimés du stockage. Pour plus d’informations sur la façon dont W\&B supprime les artifacts, voir la page [Supprimer des 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 conservation des données avec Artifacts TTL dans W\&B App.

<Note>
  W\&B désactive l’option permettant de définir une politique TTL pour les artifacts liés au registre. Cela permet de garantir que les artifacts liés n’expirent pas accidentellement s’ils sont utilisés dans des flux de travail de Production.
</Note>

<Note>
  * Seuls les Administrateurs d’équipe peuvent consulter les [paramètres d’une équipe](/fr/platform/app/settings-page/teams) et accéder aux paramètres TTL au niveau de l’équipe, notamment pour (1) définir qui peut créer ou modifier une politique TTL ou (2) définir une valeur TTL par défaut pour l’équipe.
  * Si vous ne voyez pas l’option permettant de définir ou de modifier une politique TTL dans les détails d’un artifact dans l’interface de l’application W\&B, ou si la définition programmatique d’une TTL ne modifie pas correctement la propriété TTL d’un artifact, votre administrateur d’équipe ne vous a pas accordé les autorisations nécessaires.
</Note>

<div id="auto-generated-artifacts">
  ## Artifacts générés automatiquement
</div>

Seuls les Artifacts générés par des utilisateurs peuvent utiliser des politiques TTL. Il n’est pas possible de définir de politiques TTL pour les Artifacts générés automatiquement par W\&B.

Les types d'Artifact suivants indiquent 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/models/artifacts/explore-and-traverse-an-artifact-graph/) ou par programmation :

```python theme={null}
import wandb

with wandb.init(project="<my-project-name>") as run:
    artifact = run.use_artifact(artifact_or_name="<my-artifact-name>")
    print(artifact.type)
```

Remplacez les valeurs entre `<>` par les vôtres.

<div id="define-who-can-edit-and-set-ttl-policies">
  ## Définir qui peut modifier et définir des politiques TTL
</div>

Définissez qui peut définir et modifier des politiques TTL au sein d’une équipe. Vous pouvez accorder les autorisations TTL uniquement aux administrateurs d’équipe, ou les accorder à la fois aux administrateurs d’équipe et aux membres de l’équipe.

<Note>
  Seuls les administrateurs d’équipe peuvent définir qui peut définir ou modifier une politique TTL.
</Note>

1. Accédez à la page de profil de votre équipe.
2. Sélectionnez l’onglet **Paramètres**.
3. Accédez à la **section Durée de vie (TTL) des Artéfacts**.
4. Dans le **menu déroulant des autorisations TTL**, sélectionnez qui peut définir et modifier des politiques TTL.
5. Cliquez sur **Vérifier et enregistrer les paramètres**.
6. Confirmez les modifications, puis sélectionnez **Enregistrer les paramètres**.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/artifacts/define_who_sets_ttl.gif?s=a67b5d3fed731c08c3645aaa8298c853" alt="Configuration des autorisations TTL" width="2318" height="2262" data-path="images/artifacts/define_who_sets_ttl.gif" />
</Frame>

<div id="create-a-ttl-policy">
  ## Créer une politique TTL
</div>

Définissez une politique TTL pour un artifact soit au moment de créer l’artifact, soit rétroactivement une fois l’artifact créé.

Pour tous les extraits de code ci-dessous, remplacez le contenu entre `<>` par vos informations afin d’utiliser l’extrait de code.

<div id="set-a-ttl-policy-when-you-create-an-artifact">
  ### Définir une politique TTL lors de la création d’un artifact
</div>

Utilisez le SDK Python de W\&B pour définir une politique TTL lors de la création d’un artifact. Les politiques TTL sont généralement définies en jours.

<Note>
  Définir une politique TTL lors de la création d’un artifact est similaire à la procédure habituelle pour [créer un artifact](/fr/models/artifacts/construct-an-artifact/). La seule différence est que vous transmettez un intervalle de temps à l’attribut `ttl` de l’artifact.
</Note>

Les étapes sont les suivantes :

1. [Créez un artifact](/fr/models/artifacts/construct-an-artifact/).
2. [Ajoutez du contenu à l’artifact](/fr/models/artifacts/construct-an-artifact/#add-files-to-an-artifact), comme des fichiers, un répertoire ou une référence.
3. Définissez une durée TTL à l’aide du type de données [`datetime.timedelta`](https://docs.python.org/3/library/datetime.html), qui fait partie de la bibliothèque standard de Python.
4. [Enregistrez l’artifact](/fr/models/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={null}
import wandb
from datetime import timedelta

with wandb.init(project="<my-project-name>", entity="<my-entity>") as run:
    artifact = wandb.Artifact(name="<artifact-name>", type="<type>")
    artifact.add_file("<my_file>")

    artifact.ttl = timedelta(days=30)  # Définir la politique TTL
    run.log_artifact(artifact)
```

L’extrait de code précédent définit la politique TTL de l’artifact à 30 jours. En d’autres termes, W\&B supprime l’artifact après 30 jours.

<div id="set-or-edit-a-ttl-policy-after-you-create-an-artifact">
  ### Définir ou modifier une politique TTL après la création d’un artifact
</div>

Utilisez la interface W\&B App ou le W\&B Python SDK pour définir une politique TTL pour un artifact existant.

<Note>
  Lorsque vous modifiez le TTL d’un artifact, le délai avant expiration est toujours calculé à partir du timestamp `createdAt` de l’artifact.
</Note>

<Tabs>
  <Tab title="Python SDK">
    1. [Récupérez votre artifact](/fr/models/artifacts/download-and-use-an-artifact/).
    2. Affectez un delta de temps à l’attribut `ttl` de l’artifact.
    3. Mettez à jour l’artifact avec la méthode [`save`](/fr/models/ref/python/experiments/run#save).

    L’extrait de code suivant montre comment définir une politique TTL pour un artifact :

    ```python theme={null}
    import wandb
    from datetime import timedelta

    artifact = run.use_artifact("<my-entity/my-project/my-artifact:alias>")
    artifact.ttl = timedelta(days=365 * 2)  # Supprimer dans deux ans
    artifact.save()
    ```

    L’exemple de code précédent définit la politique TTL sur deux ans.
  </Tab>

  <Tab title="W&B App">
    1. Accédez à votre projet W\&B dans la interface W\&B App.
    2. Sélectionnez l’icône artifact 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 le menu déroulant, sélectionnez **Edit TTL policy**.
    7. Dans la fenêtre modale qui s’affiche, sélectionnez **Custom** dans le menu déroulant de la politique TTL.
    8. Dans le champ **TTL duration**, définissez la politique TTL en nombre de jours.
    9. Sélectionnez le bouton **Update TTL** pour enregistrer vos modifications.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/artifacts/edit_ttl_ui.gif?s=122e57ef7a39d1e5704905254187e689" alt="Modification de la politique TTL" width="2678" height="2072" data-path="images/artifacts/edit_ttl_ui.gif" />
    </Frame>
  </Tab>
</Tabs>

<div id="set-default-ttl-policies-for-a-team">
  ### Définir des politiques TTL par défaut pour une équipe
</div>

<Note>
  Seuls les administrateurs d’équipe peuvent définir une politique TTL par défaut pour une équipe.
</Note>

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 pour lesquels une politique TTL est déjà définie au niveau de la version ne sont pas affecté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 **Paramètres**.
3. Accédez à la **section Durée de vie (TTL) des Artéfacts**.
4. Cliquez sur **Définir la politique TTL par défaut de l’équipe**.
5. Dans le champ **Durée**, 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**.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/artifacts/set_default_ttl.gif?s=768028aad37ace11f6175f4f709163ff" alt="Définition de la politique TTL par défaut" width="2326" height="2254" data-path="images/artifacts/set_default_ttl.gif" />
</Frame>

<div id="set-a-ttl-policy-outside-of-a-run">
  ### Définir une politique TTL en dehors d’un run
</div>

Utilisez l’API publique pour récupérer un artifact sans avoir à récupérer de run, puis définissez la politique TTL. Les politiques TTL sont généralement définies en jours.

L’exemple de code suivant montre comment récupérer un artifact à l’aide de l’API publique et définir la politique TTL.

```python theme={null}
api = wandb.Api()

artifact = api.artifact("entity/project/artifact:alias")

artifact.ttl = timedelta(days=365)  # Suppression dans un an

artifact.save()
```

<div id="deactivate-a-ttl-policy">
  ## Désactiver une politique TTL
</div>

Utilisez le SDK Python de W\&B ou l’interface de l’application W\&B pour désactiver une politique TTL pour une version spécifique d’un artifact.

<Tabs>
  <Tab title="Python SDK">
    1. [Récupérez votre artifact](/fr/models/artifacts/download-and-use-an-artifact/).
    2. Définissez l’attribut `ttl` de l’artifact sur `None`.
    3. Mettez à jour l’artifact avec la méthode [`save`](/fr/models/ref/python/experiments/run#save).

    L’extrait de code suivant montre comment désactiver une politique TTL pour un artifact :

    ```python theme={null}
    artifact = run.use_artifact("<my-entity/my-project/my-artifact:alias>")
    artifact.ttl = None
    artifact.save()
    ```
  </Tab>

  <Tab title="W&B App">
    1. Accédez à votre projet W\&B dans l’interface de l’application W\&B.
    2. Sélectionnez l’icône artifact dans la barre latiale du projet.
    3. Dans la liste des artifacts, développez le type d’artifact concerné.
    4. Sélectionnez la version d’artifact pour laquelle vous souhaitez modifier la politique TTL.
    5. Cliquez sur l’onglet Version.
    6. Cliquez sur le menu **action (<Icon icon="ellipsis" iconType="solid" />)** à côté du bouton **Link to registry**.
    7. Dans le menu déroulant, sélectionnez **Edit TTL policy**.
    8. Dans la fenêtre modale qui s’affiche, sélectionnez **Deactivate** dans le menu déroulant de la politique TTL.
    9. Sélectionnez le bouton **Update TTL** pour enregistrer vos modifications.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/artifacts/remove_ttl_polilcy.gif?s=ba302facbabcece978e6ad2be7466d32" alt="Suppression d’une politique TTL" width="2678" height="1892" data-path="images/artifacts/remove_ttl_polilcy.gif" />
    </Frame>
  </Tab>
</Tabs>

<div id="view-ttl-policies">
  ## Consulter les politiques TTL
</div>

Consultez les politiques TTL des artifacts avec le SDK Python ou l'interface W\&B App.

<Tabs>
  <Tab title="Python SDK">
    Utilisez une instruction `print` pour consulter la politique TTL d'un artifact. L'exemple suivant montre comment récupérer un artifact et consulter sa politique TTL :

    ```python theme={null}
    artifact = run.use_artifact("<my-entity/my-project/my-artifact:alias>")
    print(artifact.ttl)
    ```
  </Tab>

  <Tab title="W&B App">
    Consultez la politique TTL d'un artifact dans l'interface W\&B App.

    1. Accédez à [W\&B App](https://wandb.ai).
    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.

    Dans la vue de la collection, vous pouvez voir tous les artifacts de la collection sélectionnée. Dans la colonne `Time to Live`, vous verrez la politique TTL attribuée à cet artifact.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/artifacts/ttl_collection_panel_ui.png?fit=max&auto=format&n=wKCrMJZKG3PxyJhv&q=85&s=f272a57be017a5aaa53fefc0cb04acda" alt="vue de la collection TTL" width="1610" height="831" data-path="images/artifacts/ttl_collection_panel_ui.png" />
    </Frame>
  </Tab>
</Tabs>
