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

# Supprimer des runs

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

<h2 id="delete-runs">
  Supprimer des runs
</h2>

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

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

    Pour les projets qui contiennent un grand nombre de runs, vous pouvez filtrer les runs à supprimer à l’aide d’une expression régulière dans la barre de recherche, ou utiliser le bouton de filtre pour les filtrer selon leur statut, 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. Vous pouvez supprimer un seul run ou plusieurs runs à la fois.

    Utilisez [`wandb.Api.Run.delete()`](/fr/products/wandb/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={"system"}
    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-les un par un. L’exemple suivant supprime tous les runs d’un projet :

    ```python theme={"system"}
    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 qui répondent à 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={"system"}
    import wandb

    api = wandb.Api()

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

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

    # Effectuer d’abord une simulation à blanc
    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 certains fichiers joints à un run, comme des médias journalisés :

    1. Obtenez les descripteurs des fichiers concernés avec [`wandb.Api.Run.files()`](/fr/products/wandb/ref/python/public-api/run#method-run-files).
    2. Utilisez [`File.delete()`](/fr/products/wandb/ref/python/public-api/file#method-file-delete) pour supprimer chaque fichier.
  </Tab>
</Tabs>

Un ID de run ne peut pas être réutilisé, même après la suppression du run : toute tentative fera échouer le run avec une erreur.

<Warning>
  Lorsque vous supprimez un run en choisissant de supprimer également les artifacts associés, ceux-ci sont définitivement supprimés et ne peuvent pas être récupérés, même si le run est restauré par la suite. Cela inclut les artifacts liés au registre.
</Warning>

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

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

```mermaid theme={"system"}
graph TB
    Start([L’utilisateur lance<br/>la suppression du run]) --> RunSelect[Sélectionner les runs<br/>à supprimer]
    RunSelect --> DeletePrompt{Supprimer les artifacts<br/>associés ?}
    DeletePrompt -->|Non| DeleteRunOnly[Supprimer uniquement le run<br/><br/>- Métadonnées du run supprimées<br/>- Artifacts toujours disponibles<br/>- Accès aux artifacts toujours possible]
    DeletePrompt -->|Oui| CheckArtifacts[Vérifier la présence<br/>d’artifacts associés]
    CheckArtifacts --> HasRegistry{Artifacts liés au<br/>registre de modèles ?}
    HasRegistry -->|Oui| RegistryWarning[⚠️ Avertissement<br/><br/>Les modèles du registre seront supprimés<br/>Les alias de production seront affectés]
    HasRegistry -->|Non| DirectDelete
    RegistryWarning --> ConfirmRegistry{Confirmer la suppression<br/>des modèles du registre ?}
    ConfirmRegistry -->|Non| DeleteRunOnly
    ConfirmRegistry -->|Oui| DirectDelete[Supprimer le run + les artifacts<br/><br/>- Métadonnées du run supprimées<br/>- Artifacts définitivement supprimés<br/>- Liens vers le registre supprimés<br/>- Récupération impossible]
    DeleteRunOnly --> PartialEnd([Run supprimé<br/>Artifacts conservés])
    DirectDelete --> FullEnd([Run + artifacts<br/>définitivement supprimés])
    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
```

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

Sur le [Cloud dédié de W\&B](/fr/products/wandb/platform/hosting/hosting-options/dedicated-cloud) et sur [W\&B autogéré](/fr/products/wandb/platform/hosting/hosting-options/self-managed), la variable d’environnement `GORILLA_DATA_RETENTION_PERIOD` détermine la durée de conservation des **données de runs supprimés** avant qu’elles puissent être définitivement effacées du stockage d’objets. **Les artifacts ne sont pas concernés par ce paramètre** ; ils suivent le processus de suppression des artifacts et de garbage collection décrit dans [Supprimer un artifact](/fr/products/wandb/artifacts/delete-artifacts).

La définition ou la modification de `GORILLA_DATA_RETENTION_PERIOD` est irréversible pour les données situées au-delà 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 raccourcir la durée. Consultez [Configurer les variables d’environnement](/fr/products/wandb/platform/hosting/env-vars) pour le tableau de référence et les avertissements.

Même après la suppression d’un run ou d’un fichier et le traitement de la rétention, **l’espace occupé dans le bucket peut mettre du temps à diminuer**, le temps que les tâches en arrière-plan rattrapent leur retard. W\&B ne garantit pas la libération immédiate de l’espace de stockage d’objets. Pour un aperçu complet de la distinction entre artifacts et données de runs, des délais à prévoir et des actions facultatives côté opérateur, consultez [Gérer le stockage et les coûts des buckets](/fr/products/wandb/platform/hosting/managing-bucket-storage).

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