# Gerenciando o runtime do seu Space

Consulte a página de documentação do [HfApi](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi) para a referência dos métodos de gerenciamento do seu Space no Hub.

- Obter o runtime atual: [get_space_runtime()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime)
- Obter logs de build ou execução: [fetch_space_logs()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.fetch_space_logs)
- Gerenciar segredos: [add_space_secret()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.add_space_secret) e [delete_space_secret()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.delete_space_secret)
- Gerenciar hardware: [request_space_hardware()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware)
- Gerenciar estado: [pause_space()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.pause_space), [restart_space()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.restart_space), [set_space_sleep_time()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.set_space_sleep_time)
- Aguarde até que o Space esteja pronto: [wait_for_space()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.wait_for_space)
- Verifique sua cota de ZeroGPU: [get_zero_gpu_quota()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota)

## Estruturas de dados

### SpaceRuntime[[huggingface_hub.SpaceRuntime]]

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

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

[Fonte](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L201)

**Parâmetros:**

stage (`str`) : Etapa atual do espaço. Exemplo: RUNNING.

hardware (`str` ou `None`) : Hardware atual do espaço. Exemplo: "cpu-basic". Pode ser `None` se o Space estiver `BUILDING` pela primeira vez.

requested_hardware (`str` ou `None`) : Hardware solicitado. Pode ser diferente de `hardware`, especialmente se a solicitação acabou de ser feita. Exemplo: "t4-medium". Pode ser `None` se nenhum hardware tiver sido solicitado ainda.

sleep_time (`int` ou `None`) : Número de segundos que o Space permanecerá ativo após a última solicitação. Por padrão (se o valor for `None`), o Space nunca entrará em modo de suspensão se estiver executado em hardware atualizado, enquanto entrará em modo de suspensão após 48 horas em um hardware gratuito 'cpu-basic'. Para mais detalhes, consulte https://huggingface.co/docs/hub/spaces-gpus#sleep-time.

volumes (`list[Volume]` ou `None`) : Lista de volumes montados no Space. Cada volume é um objeto [Volume](/docs/huggingface_hub/main/pt/package_reference/jobs#huggingface_hub.Volume) que descreve seu tipo, origem, caminho de montagem e configurações opcionais. `None` se nenhum volume estiver anexado.

raw (`dict`) : Resposta bruta do servidor. Contém mais informações sobre o runtime do Space, como número de réplicas, número de CPUs, tamanho da memória, ...

Contém informações sobre o tempo de execução atual de um 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)
```

[Fonte](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L68)

Enumeração dos hardwares disponíveis para executar seu Space no Hub.

O valor pode ser comparado a uma string:
```py
assert SpaceHardware.CPU_BASIC == "cpu-basic"
```

Retirado de https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (URL privada).

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

[Fonte](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L22)

Enumeração dos possíveis estágios de um Space no Hub.

O valor pode ser comparado a uma string:
```py
assert SpaceStage.BUILDING == "BUILDING"
```

Retirado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (url privada).

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

[Fonte](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L110)

Enumeração do armazenamento persistente disponível para seu Space no Hub.

O valor pode ser comparado a uma string:
```py
assert SpaceStorage.SMALL == "small"
```

Retirado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (url privada).

### SpaceVariable[[huggingface_hub.SpaceVariable]]

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

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

[Fonte](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L280)

**Parâmetros:**

key (`str`) : Chave da variável. Exemplo: `"MODEL_REPO_ID"`

value (`str`) : Valor da variável. Exemplo: `"the_model_repo_id"`.

description (`str` or None) : Descrição da variável. Exemplo: `"Model Repo ID of the implemented model"`.

updatedAt (`datetime` ou None) : data e hora da última atualização da variável (se a variável tiver sido atualizada pelo menos uma vez).

Contém informações sobre as variáveis atuais de um Space.

### SpaceTemplate[[huggingface_hub.SpaceTemplate]]

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

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

[Fonte](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L375)

**Parâmetros:**

name (`str`) : Nome amigável do template (por exemplo, `"JupyterLab"`, `"chatbot"`).

repo_id (`str`) : ID do repositório do Space de modelo (ex.: `"SpacesExamples/jupyterlab"`).

sdk (`str`) : SDK com o qual o template é construído (por exemplo, `"gradio"`, `"docker"`, `"static"`).

preferred_private (`bool`) : Se os Spaces criados a partir deste template devem ser recomendados como privados.

Contém informações sobre um modelo de Space disponível no Hub.

Retornado por [HfApi.list_space_templates()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates). O `repo_id` pode ser passado como `space_template` para [HfApi.create_repo()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.create_repo) para criar um novo Space a partir desse modelo.

### ZeroGpuQuota[[huggingface_hub.ZeroGpuQuota]]

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

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

[Fonte](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L406)

**Parâmetros:**

base (`float`) : Cota total, em segundos de GPU.

remaining (`float`) : Cota restante, em segundos de GPU.

resets_at (`datetime` ou `None`) : Data em que a cota será redefinida. `None` se a cota ainda não tiver sido utilizada.

overquota_used (`float` ou `None`) : Segundos de GPU pagos consumidos após a exaustão da cota base. Usuários PRO, Team e Enterprise podem comprar créditos para ultrapassar a cota base em https://huggingface.co/settings/billing?add-credits=true.

Contém informações sobre a cota ZeroGPU do usuário autenticado.

A cota ZeroGPU é consumida cada vez que você usa um Space ZeroGPU (pela interface ou por meio de sua API) e é redefinida periodicamente. Consulte https://huggingface.co/docs/hub/spaces-zerogpu para mais detalhes.

Retornado por [HfApi.get_zero_gpu_quota()](/docs/huggingface_hub/main/pt/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota).