# Управление средой выполнения вашего Space

См. страницу документации [HfApi](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi) для справочника методов управления вашим Space на Hub.

- Получить текущее время выполнения: [get_space_runtime()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime)
- Получить журналы сборки или выполнения: [fetch_space_logs()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.fetch_space_logs)
- Управление секретами: [add_space_secret()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.add_space_secret) и [delete_space_secret()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.delete_space_secret)
- Управление оборудованием: [request_space_hardware()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware)
- Управление состоянием: [pause_space()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.pause_space), [restart_space()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.restart_space), [set_space_sleep_time()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.set_space_sleep_time)
- Дождитесь, пока Space будет готов: [wait_for_space()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.wait_for_space)
- Проверьте вашу квоту ZeroGPU: [get_zero_gpu_quota()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota)

## Структуры данных

### SpaceRuntime[[huggingface_hub.SpaceRuntime]]

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

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

[Источник](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L201)

**Параметры:**

stage (`str`) : Текущая стадия пространства. Пример: RUNNING.

hardware (`str` или `None`) : Текущее оборудование Space. Пример: "cpu-basic". Может быть `None`, если Space находится в состоянии `BUILDING` при первой сборке.

requested_hardware (`str` или `None`) : Запрованное оборудование. Может отличаться от `hardware`, особенно если запрос был сделан недавно. Пример: "t4-medium". Может быть `None`, если оборудование еще не запрашивалось.

sleep_time (`int` или `None`) : Количество секунд, в течение которых Space будет оставаться активным после последнего запроса. По умолчанию (если значение равно `None`), Space никогда не переходит в спящий режим, если работает на обновлённом оборудовании, тогда как на бесплатном оборудовании 'cpu-basic' он переходит в спящий режим через 48 часов. Подробнее см. https://huggingface.co/docs/hub/spaces-gpus#sleep-time.

volumes (`list[Volume]` или `None`) : Список томов, смонтированных в Space. Каждый том представляет собой объект [Volume](/docs/huggingface_hub/main/ru/package_reference/jobs#huggingface_hub.Volume), описывающий его тип, источник, путь монтирования и необязательные параметры. `None`, если тома не подключены.

raw (`dict`) : Сырой ответ от сервера. Содержит дополнительную информацию о рантайме Space, например, количество реплик, количество CPU, размер памяти и т. д.

Содержит информацию о текущем времени выполнения 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)
```

[Источник](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L68)

Перечень доступных аппаратных конфигураций для запуска вашего Space на Hub.

Значение можно сравнить со строкой:
```py
assert SpaceHardware.CPU_BASIC == "cpu-basic"
```

Взято с https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (приватный URL).

### 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)
```

[Источник](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L22)

Перечисление возможных стадий Space на Hub.

Значение можно сравнить со строкой:
```py
assert SpaceStage.BUILDING == "BUILDING"
```

Взято из https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (приватный URL).

### 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)
```

[Источник](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L110)

Перечень вариантов постоянного хранилища, доступных для вашего Space на Hub.

Значение можно сравнить со строкой:
```py
assert SpaceStorage.SMALL == "small"
```

Взято с https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (приватный URL).

### SpaceVariable[[huggingface_hub.SpaceVariable]]

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

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

[Источник](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L280)

**Параметры:**

key (`str`) : Ключ переменной. Пример: `"MODEL_REPO_ID"`

value (`str`) : Значение переменной. Пример: `"the_model_repo_id"`.

description (`str` или None) : Описание переменной. Пример: `"Model Repo ID of the implemented model"`.

updatedAt (`datetime` или None) : дата и время последнего обновления переменной (если переменная была обновлена хотя бы один раз).

Содержит информацию о текущих переменных Space.

### SpaceTemplate[[huggingface_hub.SpaceTemplate]]

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

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

[Источник](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L375)

**Параметры:**

name (`str`) : Человекочитаемое имя шаблона (например, `"JupyterLab"`, `"chatbot"`).

repo_id (`str`) : Идентификатор репозитория шаблонного Space (например, `"SpacesExamples/jupyterlab"`).

sdk (`str`) : SDK, с которым создан шаблон (например, `"gradio"`, `"docker"`, `"static"`).

preferred_private (`bool`) : Указывает, рекомендуется ли создавать Spaces из этого шаблона как приватные.

Содержит информацию о шаблоне Space, доступном на Hub.

Возвращается методом [HfApi.list_space_templates()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates). Значение `repo_id` можно передать в качестве параметра `space_template` в метод [HfApi.create_repo()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.create_repo), чтобы создать новое Space на основе этого шаблона.

### ZeroGpuQuota[[huggingface_hub.ZeroGpuQuota]]

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

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

[Источник](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L406)

**Параметры:**

base (`float`) : Общая квота, в секундах GPU.

remaining (`float`) : Оставшаяся квота, в секундах GPU.

resets_at (`datetime` или `None`) : Дата, когда квота будет сброшена. `None`, если квота ещё не использовалась.

overquota_used (`float` или `None`) : Количество оплаченных GPU-секунд, потребленных после исчерпания базовой квоты. Пользователи тарифов PRO, Team и Enterprise могут приобрести кредиты, чтобы превысить базовую квоту, по адресу https://huggingface.co/settings/billing?add-credits=true.

Содержит информацию о квоте ZeroGPU для аутентифицированного пользователя.

Квота ZeroGPU расходуется каждый раз, когда вы используете Space с ZeroGPU (из пользовательского интерфейса или через его API), и периодически сбрасывается. Подробнее см. https://huggingface.co/docs/hub/spaces-zerogpu

Возвращается методом [HfApi.get_zero_gpu_quota()](/docs/huggingface_hub/main/ru/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota).