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

# 함수

> 조직에 표시되는 러너를 쿼리하세요.

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

소스: [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]
```

사용 가능한 러너를 선택적으로 필터링합니다.
**매개변수**

* `auth` (`AuthConfig | None`): 이 요청에 대한 인증 전략, 확인된 헤더 또는 공급자입니다.
* `runner_group_id` (`str | None`): 이 runner group으로 결과를 제한합니다.
* `gpu_type` (`str | None`): 이 GPU 유형을 지원하는 러너만 반환합니다.
* `architecture` (`str | None`): 이 CPU architecture를 지원하는 러너만 반환합니다.
* `healthy_only` (`bool`): healthy한 러너만 반환합니다.
* `include_resources` (`bool`): `True`인 경우, live 리소스 가용성을 포함합니다.
* `min_available_cpu_millicores` (`int | None`): unreserved CPU에 대한 client-side filter입니다.
* `min_available_memory_bytes` (`int | None`): unreserved 메모리에 대한 client-side filter입니다.
* `min_available_gpu_count` (`int | None`): unreserved GPU에 대한 client-side filter입니다.
* `service_visibility` (`str | None`): 이 유형 지정 visibility (`public` / `private` / `custom`)를 강제 적용할 수 있는 러너를 요구합니다.

**반환값**

* `list[Runner]`: 필터와 일치하는 `Runner` objects의 목록입니다.

***

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

소스: [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
```

`(organization_id, runner_id)`로 단일 러너를 조회합니다.

소유한 러너인 경우 리소스 가용성을 포함한 전체 세부 정보를 항상 반환합니다.
**매개변수**

* `runner_id` (`str`): 러너 식별자(단독으로는 전역적으로 고유하지 않음).
* `organization_id` (`str`): 러너를 소유한 조직.
* `auth` (`AuthConfig | None`): 이 요청의 인증 전략, 확인된 헤더 또는 공급자.

**반환값**

* `Runner`: 전체 세부 정보가 포함된 `Runner`.

***

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

소스: [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">
  이진 단위를 사용하여 바이트를 사람이 읽기 쉬운 문자열로 형식화합니다.
</h2>

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

소스: [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">
  CPU millicores를 사람이 읽을 수 있는 문자열로 포맷합니다.
</h2>