> Source: https://clickhouse.github.io/loom/ko/reference/operations/admin/ (Markdown: https://clickhouse.github.io/loom/ko/reference/operations/admin.md)

<!-- i18n: source=docs/reference/operations/admin.md blob=f39b9129b91eb2d7bee29920a25a97a24df4b80b model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://clickhouse.github.io/loom/reference/operations/admin/)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/admin/), which is authoritative.

<a id="admin-operations"></a>

# `admin` 오퍼레이션

각 `admin.*` 오퍼레이션이 받고 반환하는 정확한 필드입니다.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

모든 op는 HTTP의 `POST /v1/<op>`이자 MCP 도구 `loom_<op>`입니다. 신원 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 전송 방식이 가능한 경우 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, `code.*`와 `tracker.*`(각자의 플레인 값을 유지)를 제외한 모든 op에서 설치의 org가 채워지고, [일부 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 [신원과 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [오퍼레이션 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 role, kind, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 `ignored_args`에 이름이 표시됩니다.

<!-- prettier-ignore-start -->

<a id="adminusers"></a>

## `admin.users`

namespace_grants와 namespaces.owner_email에서 주체를 집계하고, 감사 로그의 마지막 활동 시각을 결합하며, 설정된 플랫폼 관리자를 표시합니다.

`POST /v1/admin.users` · MCP `loom_admin_users` · role `org_admin` · 멱등 · MCP `all` 툴셋에는 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `namespace` | `str \| None` | `None` | op가 읽거나 쓰는 네임스페이스. |
| `include_service_accounts` | `bool` | `False` | 연락처 이메일도 비밀번호도 없는 주체(서비스 계정)도 함께 나열합니다. 꺼져 있으면 제외됩니다. |
| `limit` | `int` | `200` | 주체 순서로 최대 이 개수만큼의 사용자를 반환합니다. 1에서 1,000까지. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `users` | `list[UserSummary]` | 주체 순서로 정렬된 사용자 페이지이며, 각 사용자에 부여된 권한과 소유한 네임스페이스가 포함됩니다. |
| `total` | `int` | `limit` 적용 전에 필터와 일치한 사용자 수. |
| `total_pending_elevations` | `int` | 이 페이지에서 승인되지 않은 권한 상승 요청이 있는 권한 수. |
| `total_active_last_7d` | `int` | 이 페이지에서 최근 7일 이내에 감사 행이 있는 사용자 수. |
| `platform_admins_configured` | `list[str]` | 설정된 플랫폼 관리자 신원을 정렬한 목록. 호출자가 플랫폼 관리자가 아니면(인증이 꺼진 경우 제외) 비어 있습니다. |

<!-- prettier-ignore-end -->
