# Gérer le runtime de votre Space

Consultez la page de documentation de [HfApi](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi) pour la référence des méthodes permettant de gérer votre Space sur le Hub.

- Récupérer le runtime actuel : [get_space_runtime()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime)
- Récupérer les journaux de build ou d’exécution : [fetch_space_logs()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.fetch_space_logs)
- Gérer les secrets : [add_space_secret()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.add_space_secret) et [delete_space_secret()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.delete_space_secret)
- Gérer le matériel : [request_space_hardware()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware)
- Gérer l'état : [pause_space()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.pause_space), [restart_space()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.restart_space), [set_space_sleep_time()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.set_space_sleep_time)
- Attendez que Space soit prêt : [wait_for_space()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.wait_for_space)
- Vérifiez votre quota ZeroGPU : [get_zero_gpu_quota()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota)

## Structures de données

### SpaceRuntime[[huggingface_hub.SpaceRuntime]]

#### huggingface_hub.SpaceRuntime[[huggingface_hub.SpaceRuntime]]

```python
huggingface_hub.SpaceRuntime(data: dict)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L201)

**Paramètres :**

stage (`str`) : Étape actuelle de l'espace. Exemple : RUNNING.

hardware (`str` ou `None`) : Matériel actuel de l'espace. Exemple : "cpu-basic". Peut être `None` si l'espace est en `BUILDING` pour la première fois.

requested_hardware (`str` ou `None`) : Matériel demandé. Peut différer de `hardware`, en particulier si la demande vient d'être effectuée. Exemple : "t4-medium". Peut être `None` si aucun matériel n'a encore été demandé.

sleep_time (`int` ou `None`) : Nombre de secondes pendant lesquelles le Space restera actif après la dernière requête. Par défaut (si la valeur est `None`), le Space ne passera jamais en veille s'il fonctionne sur un matériel amélioré, tandis qu'il passera en veille après 48 heures sur un matériel gratuit « cpu-basic ». Pour plus de détails, voir https://huggingface.co/docs/hub/spaces-gpus#sleep-time.

volumes (`list[Volume]` ou `None`) : Liste des volumes montés dans le Space. Chaque volume est un objet [Volume](/docs/huggingface_hub/v2.4.0/fr/package_reference/jobs#huggingface_hub.Volume) décrivant son type, sa source, son chemin de montage et ses paramètres optionnels. `None` si aucun volume n'est attaché.

raw (`dict`) : Réponse brute du serveur. Contient des informations supplémentaires sur le runtime de l'espace, telles que le nombre de répliques, le nombre de CPU, la taille de la mémoire, etc.

Contient des informations sur l'exécution actuelle d'un Space.

### SpaceHardware[[huggingface_hub.SpaceHardware]]

#### huggingface_hub.SpaceHardware[[huggingface_hub.SpaceHardware]]

```python
huggingface_hub.SpaceHardware(value, names = None, module = None, qualname = None, type = None, start = 1)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L68)

Énumération des matériels disponibles pour exécuter votre Space sur le Hub.

La valeur peut être comparée à une chaîne de caractères :
```py
assert SpaceHardware.CPU_BASIC == "cpu-basic"
```

Extrait de https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (URL privée).

### SpaceStage[[huggingface_hub.SpaceStage]]

#### huggingface_hub.SpaceStage[[huggingface_hub.SpaceStage]]

```python
huggingface_hub.SpaceStage(value, names = None, module = None, qualname = None, type = None, start = 1)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L22)

Énumération des stades possibles d'un Space sur le Hub.

La valeur peut être comparée à une chaîne de caractères :
```py
assert SpaceStage.BUILDING == "BUILDING"
```

Extrait de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (URL privée).

### SpaceStorage[[huggingface_hub.SpaceStorage]]

#### huggingface_hub.SpaceStorage[[huggingface_hub.SpaceStorage]]

```python
huggingface_hub.SpaceStorage(value, names = None, module = None, qualname = None, type = None, start = 1)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L110)

Énumération du stockage persistant disponible pour votre Space sur le Hub.

La valeur peut être comparée à une chaîne de caractères :
```py
assert SpaceStorage.SMALL == "small"
```

Extrait de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (URL privée).

### SpaceVariable[[huggingface_hub.SpaceVariable]]

#### huggingface_hub.SpaceVariable[[huggingface_hub.SpaceVariable]]

```python
huggingface_hub.SpaceVariable(key: str, values: dict)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L280)

**Paramètres :**

key (`str`) : Clé de variable. Exemple : `"MODEL_REPO_ID"`

value (`str`) : valeur de la variable. Exemple : `"the_model_repo_id"`.

description (`str` ou None) : Description de la variable. Exemple : `"Model Repo ID of the implemented model"`.

updatedAt (`datetime` ou None) : date et heure de la dernière mise à jour de la variable (si la variable a été mise à jour au moins une fois).

Contient des informations sur les variables actuelles d'un Space.

### SpaceTemplate[[huggingface_hub.SpaceTemplate]]

#### huggingface_hub.SpaceTemplate[[huggingface_hub.SpaceTemplate]]

```python
huggingface_hub.SpaceTemplate(data: dict)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L375)

**Paramètres :**

name (`str`) : Nom lisible du modèle (par ex. `"JupyterLab"`, `"chatbot"`).

repo_id (`str`) : Identifiant du dépôt de l'Espace modèle (par exemple `"SpacesExamples/jupyterlab"`).

sdk (`str`) : SDK utilisé pour construire le modèle (par exemple `"gradio"`, `"docker"`, `"static"`).

preferred_private (`bool`) : Indique si les Spaces créés à partir de ce modèle sont recommandés comme privés.

Contient des informations sur un modèle de Space disponible sur le Hub.

Retourné par [HfApi.list_space_templates()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates). Le `repo_id` peut être passé en tant que `space_template` à [HfApi.create_repo()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.create_repo) pour initialiser un nouvel espace à partir de ce modèle.

### ZeroGpuQuota[[huggingface_hub.ZeroGpuQuota]]

#### huggingface_hub.ZeroGpuQuota[[huggingface_hub.ZeroGpuQuota]]

```python
huggingface_hub.ZeroGpuQuota(data: dict)
```

[Source](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/_space_api.py#L406)

**Paramètres :**

base (`float`) : Quota total, en secondes-GPU.

remaining (`float`) : Quota restant, en secondes-GPU.

resets_at (`datetime` ou `None`) : Date à laquelle le quota sera réinitialisé. `None` si le quota n'a pas encore été utilisé.

overquota_used (`float` ou `None`) : Secondes-GPU payées au-delà de la base, consommées une fois la quota de base épuisée. Les utilisateurs PRO, Team et Enterprise peuvent acheter des crédits pour dépasser la quota de base sur https://huggingface.co/settings/billing?add-credits=true.

Contient des informations sur le quota ZeroGPU de l'utilisateur authentifié.

Le quota ZeroGPU est consommé à chaque utilisation d'un Space ZeroGPU (depuis l'interface utilisateur ou via son API) et est réinitialisé périodiquement. Consultez https://huggingface.co/docs/hub/spaces-zerogpu pour plus de détails.

Retourné par [HfApi.get_zero_gpu_quota()](/docs/huggingface_hub/v2.4.0/fr/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota).