> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-workspaces-notebooks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Supprimer des runs

> Supprimez des runs d’un projet W&B à l’aide de W&B App ou de l’API publique, et découvrez comment les données des runs supprimés sont retirées du stockage.

<div id="delete-runs">
  ## Supprimer des runs
</div>

Supprimez des runs d’un projet avec W\&B App ou l’API Python.

<Tabs>
  <Tab title="W&B App" value="ui">
    1. Accédez au projet qui contient les runs que vous souhaitez supprimer.
    2. Sélectionnez l’onglet **Runs**.
    3. Cochez la case à côté des runs que vous souhaitez supprimer.
    4. Cliquez sur le bouton **Supprimer** (icône de corbeille) au-dessus du tableau.
    5. Dans le volet latéral qui s’affiche, choisissez **Supprimer**.

    Pour les projets qui contiennent un grand nombre de runs, vous pouvez utiliser soit la barre de recherche pour filtrer les runs que vous souhaitez supprimer à l’aide d’expressions régulières, soit le bouton de filtre pour filtrer les runs en fonction de leur statut, de leurs tags ou d’autres propriétés.
  </Tab>

  <Tab title="Python" value="python">
    Utilisez l’API publique de W\&B pour supprimer des runs par programmation. Les opérations de suppression peuvent porter sur un seul run ou sur plusieurs runs à la fois.

    Utilisez [`wandb.Api.Run.delete()`](/fr/models/ref/python/public-api/run#method-run-delete) pour supprimer un seul run. Indiquez le chemin du run au format `entity/project/runID`.

    ```python theme={null}
    import wandb

    api = wandb.Api()

    run_path = "entity/project/runID"
    run = api.run(path=run_path)
    run.delete()
    ```

    Utilisez `wandb.Api.runs()` pour récupérer plusieurs runs d’un projet, puis supprimez chaque run. L’exemple suivant supprime tous les runs d’un projet :

    ```python theme={null}
    import wandb

    api = wandb.Api()

    entity = "entity"
    project = "project"

    runs = api.runs(
        path=f"{entity}/{project}")

    for run in runs:
        run.delete()
    ```

    Vous pouvez utiliser des filtres pour ne supprimer que les runs correspondant à des critères précis, comme leur date de création, leurs tags ou d’autres métadonnées. L’exemple suivant prévisualise puis supprime les runs créés avant un horodatage UTC donné :

    ```python theme={null}
    import wandb

    api = wandb.Api()

    entity = "entity"
    project = "project"
    cutoff = "2024-01-01T00:00:00Z"  # supprime les runs créés avant cet horodatage UTC

    runs = api.runs(
        path=f"{entity}/{project}",
        filters={"createdAt": {"$lt": cutoff}},
        order="+created_at",
    )

    # Simulation à blanc d'abord
    runs_to_delete = list(runs)
    print(f"Found {len(runs_to_delete)} runs to delete:")
    for run in runs_to_delete:
        print(run.id, run.name, run.created_at)

    confirm = input("Type DELETE to permanently delete these runs: ")
    if confirm == "DELETE":
        for run in runs_to_delete:
            print(f"Deleting {run.path}")
            run.delete()  # ou run.delete(delete_artifacts=True)
    ```

    Pour supprimer des fichiers individuels attachés à un run, comme des médias enregistrés :

    1. Obtenez les références de fichier pertinentes avec [`wandb.Api.Run.files()`](/fr/models/ref/python/public-api/run#method-run-files).
    2. Utilisez [`File.delete()`](/fr/models/ref/python/public-api/file#method-file-delete) pour supprimer des fichiers individuels.
  </Tab>
</Tabs>

L’ID d’un run ne peut pas être réutilisé, même après la suppression du run. Toute tentative de réutilisation échouera avec une erreur.

<Warning>
  Lorsque vous supprimez un run et choisissez de supprimer les artefacts associés, ces artefacts sont définitivement supprimés et ne peuvent pas être récupérés, même si le run est restauré ultérieurement. Cela inclut les artefacts liés au Registry.
</Warning>

<div id="run-deletion-flowchart">
  ## Organigramme de suppression d’un run
</div>

Le diagramme suivant illustre l’ensemble du processus de suppression d’un run, y compris la gestion des artefacts associés et des liens vers le Registry :

```mermaid theme={null}
graph TB
    Start([L'utilisateur lance<br/>la suppression du run]) --> RunSelect[Sélectionner les runs<br/>à supprimer]
    RunSelect --> DeletePrompt{Supprimer les<br/>artefacts associés ?}
    DeletePrompt -->|Non| DeleteRunOnly[Supprimer uniquement le run<br/><br/>- Métadonnées du run supprimées<br/>- Les artefacts restent disponibles<br/>- Les artefacts restent accessibles]
    DeletePrompt -->|Oui| CheckArtifacts[Vérifier la présence<br/>d'artefacts associés]
    CheckArtifacts --> HasRegistry{Artefacts liés au<br/>Registry de modèles ?}
    HasRegistry -->|Oui| RegistryWarning[⚠️ Avertissement<br/><br/>Les modèles du Registry seront supprimés<br/>Les alias de Production seront affectés]
    HasRegistry -->|Non| DirectDelete
    RegistryWarning --> ConfirmRegistry{Confirmer la suppression<br/>du modèle du Registry ?}
    ConfirmRegistry -->|Non| DeleteRunOnly
    ConfirmRegistry -->|Oui| DirectDelete[Supprimer le run + les artefacts<br/><br/>- Métadonnées du run supprimées<br/>- Artefacts supprimés définitivement<br/>- Liens du Registry supprimés<br/>- Récupération impossible]
    DeleteRunOnly --> PartialEnd([Run supprimé<br/>Artefacts conservés])
    DirectDelete --> FullEnd([Run + artefacts<br/>supprimés définitivement])
    style Start fill:#e1f5fe,stroke:#333,stroke-width:2px,color:#000
    style DeletePrompt fill:#fff3e0,stroke:#333,stroke-width:2px,color:#000
    style RegistryWarning fill:#ffecb3,stroke:#333,stroke-width:2px,color:#000
    style DirectDelete fill:#ffebee,stroke:#333,stroke-width:2px,color:#000
    style DeleteRunOnly fill:#e8f5e9,stroke:#333,stroke-width:2px,color:#000
    style PartialEnd fill:#c8e6c9,stroke:#333,stroke-width:2px,color:#000
    style FullEnd fill:#ffcdd2,stroke:#333,stroke-width:2px,color:#000
```

<div id="when-deleted-run-data-is-removed-from-storage">
  ## Quand les données de run supprimées sont effacées du stockage
</div>

Sur [Cloud dédié de W\&B](/fr/platform/hosting/hosting-options/dedicated-cloud) et [W\&B Autogéré](/fr/platform/hosting/hosting-options/self-managed), la variable d’environnement `GORILLA_DATA_RETENTION_PERIOD` contrôle la durée pendant laquelle les **données de run supprimées** sont conservées avant de pouvoir être supprimées définitivement du stockage d’objets. **Les artefacts ne sont pas supprimés par ce paramètre** ; ils suivent le processus de suppression des artefacts et de garbage collection décrit dans [Supprimer un artefact](/fr/models/artifacts/delete-artifacts).

Définir ou modifier `GORILLA_DATA_RETENTION_PERIOD` est irréversible pour les données déjà hors de la fenêtre de rétention. Sauvegardez votre base de données et votre bucket avant d’activer la rétention ou d’en réduire la durée. Voir [Configurer les variables d’environnement](/fr/platform/hosting/env-vars) pour le tableau de référence et les avertissements.

Même après la suppression de runs ou de fichiers et le traitement de la rétention, **l’utilisation du bucket peut mettre du temps à baisser** pendant que les tâches en arrière-plan rattrapent leur retard. W\&B ne garantit pas la récupération immédiate du stockage d’objets. Pour un aperçu complet des différences entre les artefacts et les données de run, des délais à prévoir et des actions facultatives pour l’opérateur, voir [Gérer le stockage du bucket et les coûts](/fr/platform/hosting/managing-bucket-storage).

<Note>
  Si les suppressions n’apparaissent pas comme prévu dans la W\&B App lors de l’utilisation de l’API publique, mettez à niveau le SDK Python W\&B vers une version récente, puis réessayez.
</Note>