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

> Mettre en pause, reprendre et annuler un balayage W&B avec la CLI.

# Gérer les balayages

Utilisez la [W\&B CLI](/fr/models/ref/cli/wandb-sweep) pour mettre en pause, reprendre et annuler un balayage. La commande `sweep` de la CLI utilise des indicateurs tels que `--pause` et `--resume` pour contrôler la capacité du balayage à créer de nouveaux runs W\&B, avec des effets différents sur les runs existants :

* `--pause` : lorsque vous mettez un balayage en pause, l'agent ne crée plus de nouveau run tant que vous ne reprenez pas le balayage. Les runs existants continuent de s'exécuter normalement.
* `--resume` : lorsque vous reprenez un balayage, l'agent recommence à créer de nouveaux runs selon la stratégie de recherche.
* `--stop` : lorsque vous arrêtez un balayage, l'agent cesse de créer de nouveaux runs. Les runs existants continuent jusqu'à leur terme.
* `--cancel` : lorsque vous annulez un balayage, l'agent arrête immédiatement tous les runs en cours d'exécution et cesse de créer de nouveaux runs.

Suivez les instructions ci-dessous pour mettre en pause, reprendre et annuler un balayage. Dans chaque cas, indiquez l’ID du balayage généré lorsque vous avez initialisé un balayage.

<div id="pause-a-sweep">
  ### Mettre en pause un balayage
</div>

Mettez un balayage en pause afin qu'il cesse temporairement de créer de nouveaux runs. Les Runs déjà en cours d'exécution se poursuivront jusqu'à leur achèvement. Utilisez la commande [`wandb sweep --pause`](/fr/models/ref/cli/wandb-sweep) pour mettre un balayage en pause. Indiquez l'ID du balayage que vous souhaitez mettre en pause.

```bash theme={null}
wandb sweep --pause entity/project/sweep_ID
```

<div id="resume-a-sweep">
  ### Reprendre un balayage
</div>

Reprenez un balayage en pause avec la commande [`wandb sweep --resume`](/fr/models/ref/cli/wandb-sweep). Le balayage recommencera alors à créer de nouveaux runs selon sa stratégie de recherche. Saisissez l’ID du balayage que vous souhaitez reprendre :

```bash theme={null}
wandb sweep --resume entity/project/sweep_ID
```

<div id="stop-a-sweep">
  ### Arrêter un balayage
</div>

Mettez fin à un balayage pour arrêter la création de nouveaux runs tout en laissant les runs en cours se terminer normalement. Utilisez la commande [`wandb sweep --stop`](/fr/models/ref/cli/wandb-sweep) :

```bash theme={null}
wandb sweep --stop entity/project/sweep_ID
```

<Warning>
  W\&B n’arrête pas les [balayages](/fr/models/sweeps) ni les agents en cours lorsque vous supprimez un projet.
</Warning>

<div id="cancel-a-sweep">
  ### Annuler un balayage
</div>

Annulez un balayage pour arrêter immédiatement tous les runs en cours et empêcher la création de nouveaux runs. Il s'agit de la seule commande de balayage qui interrompt de force les runs existants. Les runs sont arrêtés brutalement ; les processus en cours n'ont aucune possibilité d'exécuter des gestionnaires de signaux définis par l'utilisateur. Utilisez la commande [`wandb sweep --cancel`](/fr/models/ref/cli/wandb-sweep) pour annuler un balayage. Indiquez l'ID du balayage que vous souhaitez annuler. Pour en savoir plus sur les signaux et les runs de balayage, voir [Gestion des signaux et runs de balayage](/fr/models/sweeps/signal-handling-sweep-runs).

```bash theme={null}
wandb sweep --cancel entity/project/sweep_ID
```

Pour la liste complète des options de la commande CLI, voir le guide de référence CLI [wandb sweep](/fr/models/ref/cli/wandb-sweep).

<Warning>
  W\&B ne met pas fin aux [balayages](/fr/models/sweeps) ni aux agents actifs lorsque vous supprimez un projet.
</Warning>

<div id="understanding-sweep-and-run-statuses">
  ## Comprendre les statuts des balayages et des runs
</div>

Un balayage orchestre plusieurs runs afin d’explorer des combinaisons d’hyperparamètres. Comprendre l’interaction entre le statut du balayage et celui du run est essentiel pour gérer efficacement l’optimisation de vos hyperparamètres.

<div id="key-differences">
  ### Différences clés
</div>

* Le **statut du balayage** détermine si de nouveaux runs sont créés (Running, Paused, Stopped, Cancelled, Finished, Failed, Crashed)
* Le **statut du run** indique l’état d’exécution de chaque run (Pending, Running, Finished, Failed, Crashed, Killed)

<div id="stop-an-individual-run">
  ### Arrêter un run spécifique
</div>

Lorsque vous [arrêtez un run](/fr/models/runs/stop-runs) dans un balayage, l’agent de balayage lance automatiquement le run suivant. Cela vous permet d’ignorer les configurations peu performantes sans interrompre la progression globale du balayage.

<div id="best-practices">
  ### Bonnes pratiques
</div>

* Utilisez `--pause` plutôt que annuler lorsque vous souhaitez interrompre temporairement l'exploration sans perdre les expériences en cours
* Surveillez le statut de chaque run pour identifier les échecs systématiques
* Utilisez `--stop` pour un arrêt propre lorsque vous avez trouvé des hyperparamètres satisfaisants
* Réservez `--cancel` aux situations d'urgence, lorsque les runs consomment trop de ressources ou produisent des erreurs