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

# Fonctions

> Interrogez les exécuteurs visibles par votre organisation.

<h2 id="list_runners">
  list\_runners
</h2>

Source : [src/cwsandbox/\_discovery.py:289](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_discovery.py#L289)

```python theme={"system"}
list_runners(*, auth: AuthConfig | None = None, runner_group_id: str | None = None, gpu_type: str | None = None, architecture: str | None = None, healthy_only: bool = False, include_resources: bool = False, min_available_cpu_millicores: int | None = None, min_available_memory_bytes: int | None = None, min_available_gpu_count: int | None = None, service_visibility: str | None = None) -> list[Runner]
```

Liste les exécuteurs disponibles, avec filtrage facultatif.
**Paramètres**

* `auth` (`AuthConfig | None`) : stratégie d’authentification, en-têtes résolus ou fournisseur à utiliser pour cette requête.
* `runner_group_id` (`str | None`) : limite les résultats à ce groupe d’exécuteurs.
* `gpu_type` (`str | None`) : renvoie uniquement les exécuteurs qui prennent en charge ce type de GPU.
* `architecture` (`str | None`) : renvoie uniquement les exécuteurs qui prennent en charge cette architecture CPU.
* `healthy_only` (`bool`) : renvoie uniquement les exécuteurs en bon état de santé.
* `include_resources` (`bool`) : si `True`, inclut la disponibilité des ressources en temps réel.
* `min_available_cpu_millicores` (`int | None`) : filtre côté client sur le CPU non réservé.
* `min_available_memory_bytes` (`int | None`) : filtre côté client sur la mémoire non réservée.
* `min_available_gpu_count` (`int | None`) : filtre côté client sur les GPU non réservés.
* `service_visibility` (`str | None`) : exige un exécuteur capable d’appliquer cette visibilité typée (`public` / `private` / `custom`).

**Renvoie**

* `list[Runner]` : liste des objets `Runner` correspondant aux filtres.

***

<h2 id="get_runner">
  get\_runner
</h2>

Source : [src/cwsandbox/\_discovery.py:390](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_discovery.py#L390)

```python theme={"system"}
get_runner(runner_id: str, *, organization_id: str, auth: AuthConfig | None = None) -> Runner
```

Obtient un exécuteur précis à partir de `(organization_id, runner_id)`.

Renvoie toujours les détails complets, y compris la disponibilité des ressources lorsque vous êtes propriétaire de l’exécuteur.
**Paramètres**

* `runner_id` (`str`) : identifiant de l’exécuteur (insuffisant à lui seul pour garantir l’unicité globale).
* `organization_id` (`str`) : organisation propriétaire de l’exécuteur.
* `auth` (`AuthConfig | None`) : stratégie d’authentification, en-têtes résolus ou fournisseur à utiliser pour cette requête.

**Renvoie**

* `Runner` : `Runner` avec tous ses détails.

***

<h2 id="format_bytes">
  format\_bytes
</h2>

Source : [src/cwsandbox/\_discovery.py:39](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_discovery.py#L39)

```python theme={"system"}
format_bytes(value: int) -> str
```

<h2 id="format-bytes-as-a-human-readable-string-using-binary-units">
  Formate des octets sous forme de chaîne lisible en utilisant des unités binaires.
</h2>

<h2 id="format_cpu">
  format\_cpu
</h2>

Source : [src/cwsandbox/\_discovery.py:54](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_discovery.py#L54)

```python theme={"system"}
format_cpu(millicores: int) -> str
```

<h2 id="format-cpu-millicores-as-a-human-readable-string">
  Formate des millicores de CPU sous forme de chaîne lisible.
</h2>