# Space 런타임 관리

Hub에서 Space를 관리하는 메서드에 대한 참조는 [HfApi](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi) 문서 페이지를 확인하세요.

- 현재 런타임 가져오기: [get_space_runtime()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime)
- 빌드 또는 실행 로그 가져오기: [fetch_space_logs()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.fetch_space_logs)
- 비밀 정보 관리: [add_space_secret()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.add_space_secret) 및 [delete_space_secret()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.delete_space_secret)
- 하드웨어 관리: [request_space_hardware()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware)
- 상태 관리: [pause_space()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.pause_space), [restart_space()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.restart_space), [set_space_sleep_time()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.set_space_sleep_time)
- Space가 준비될 때까지 대기: [wait_for_space()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.wait_for_space)
- ZeroGPU 할당량을 확인하세요: [get_zero_gpu_quota()](/docs/huggingface_hub/v2.4.0/ko/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/v2.4.0/src/huggingface_hub/_space_api.py#L201)

**매개변수:**

stage (`str`) : 스페이스의 현재 단계. 예: RUNNING.

hardware (`str` 또는 `None`) : Space의 현재 하드웨어입니다. 예: "cpu-basic". Space가 처음 `BUILDING` 상태일 경우 `None`일 수 있습니다.

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/v2.4.0/ko/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/v2.4.0/src/huggingface_hub/_space_api.py#L68)

Hub에서 Space를 실행할 수 있는 하드웨어 목록

Value는 문자열과 비교할 수 있습니다:
```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/v2.4.0/src/huggingface_hub/_space_api.py#L22)

Hub의 Space에서 가능한 단계의 열거형입니다.

Value는 문자열과 비교할 수 있습니다:
```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/v2.4.0/src/huggingface_hub/_space_api.py#L110)

Hub의 Space에서 사용할 수 있는 영속적 스토리지의 목록

Value는 문자열과 비교할 수 있습니다:
```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/v2.4.0/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/v2.4.0/src/huggingface_hub/_space_api.py#L375)

**매개변수:**

name (`str`) : 템플릿의 사람이 읽기 쉬운 이름 (예: `"JupyterLab"`, `"chatbot"`).

repo_id (`str`) : 템플릿 Space의 Repo id (예: `"SpacesExamples/jupyterlab"`).

sdk (`str`) : 템플릿이 구축된 SDK (예: `"gradio"`, `"docker"`, `"static"`).

preferred_private (`bool`) : 이 템플릿으로 생성된 Spaces가 비공개로 권장되는지 여부.

Hub에서 사용할 수 있는 Space 템플릿에 대한 정보를 포함합니다.

[HfApi.list_space_templates()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates)에서 반환됩니다. `repo_id`를 [HfApi.create_repo()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.create_repo)의 `space_template`으로 전달하여 해당 템플릿에서 새로운 Space를 생성할 수 있습니다.

### ZeroGpuQuota[[huggingface_hub.ZeroGpuQuota]]

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

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

[소스](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/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 할당은 ZeroGPU Space를 사용할 때마다(UI 또는 API를 통해) 소모되며 주기적으로 초기화됩니다. 자세한 내용은 https://huggingface.co/docs/hub/spaces-zerogpu를 참조하세요.

[HfApi.get_zero_gpu_quota()](/docs/huggingface_hub/v2.4.0/ko/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota)에서 반환됩니다.