> Source: https://clickhouse.github.io/loom/ja/reference/operations/admin/ (Markdown: https://clickhouse.github.io/loom/ja/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. -->

すべての操作は、HTTP では `POST /v1/<op>`、MCP ツールでは `loom_<op>` として利用できます。ID フィールド（`org`、`namespace`、`agent`、`user_id`、`session_id`）は、トランスポートが対応している場合、トークンと MCP セッションから補完されます。単一ユーザーのサーバーでトークンなしに HTTP 呼び出しを行う場合は、`code.*` と `tracker.*`（それぞれのプレーンの値を保持します）を除くすべての操作でインストールの org が使われ、[一部の操作](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)では名前空間とエージェントも補完されます。詳細は [ID と名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)を参照してください。ロール、種別、MCP の `all` 一覧については[操作インデックス](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)で説明しています。未知の入力フィールドも処理され、`ignored_args` に名前が示されます。

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

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

## `admin.users`

namespace_grants と namespaces.owner_email からサブジェクトを集計し、監査ログから最終アクティブ日時を結合し、設定済みのプラットフォーム管理者に印を付けます。

`POST /v1/admin.users` · MCP `loom_admin_users` · ロール `org_admin` · 冪等 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str \| None` | `None` | 操作が読み書きする名前空間。 |
| `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]` | 設定済みのプラットフォーム管理者の ID（ソート済み）。呼び出し元がプラットフォーム管理者である場合（または認証がオフの場合）を除き、空になります。 |

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