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

<!-- i18n: source=docs/reference/operations/extraction_policy.md blob=28a735779ebc56e685a83b284c4e4f5f7f959a2e model=claude-sonnet-5-5 -->
> このページは[英語の原文](https://clickhouse.github.io/loom/reference/operations/extraction_policy/)の機械翻訳です。内容は英語の原文が優先されます。
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/extraction_policy/), which is authoritative.

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

# `extraction_policy` オペレーション

各 `extraction_policy.*` オペレーションが受け取るフィールドと返すフィールドの正確な定義です。

<!-- 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="extraction_policyclear"></a>

## `extraction_policy.clear`

スコープのポリシーを削除します。

`POST /v1/extraction_policy.clear` · MCP `loom_extraction_policy_clear` · ロール `org_admin` · 冪等 · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 説明 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `scope` | `Literal['org', 'namespace']` | 必須 | `org` は org 自身のポリシーを削除します。`namespace` はその名前空間のポリシーを削除し、org のポリシーはそのまま有効です。 |
| `namespace` | `str` | `''` | ポリシーを削除する名前空間。scope が `org` の場合は無視されます。 |

| 出力フィールド | 型 | 説明 |
| --- | --- | --- |
| `org` | `str` | テナント（ID タプルの最初の要素）。 |
| `scope` | `Literal['org', 'namespace']` | 指定どおりの `org` または `namespace`。 |
| `namespace` | `str` | scope が `namespace` の場合の名前空間。scope が `org` の場合は ""。 |
| `policy` | `str` | このスコープのポリシー。未設定の場合は ""。 |
| `updated_by` | `str` | 設定した主体。未設定の場合は ""。 |
| `updated_at` | `datetime \| None` | 設定された日時（UTC）。未設定の場合は None。 |
| `effective` | `str` | このスコープでの抽出が従うポリシー。org のポリシー、続いて名前空間のポリシーの順に適用されます。どちらも未設定の場合は ""。 |
| `namespace_policies` | `list[NamespacePolicy]` | scope が `org` の場合：独自のポリシーを持つ org 内のすべての名前空間を名前で列挙します。削除済みの名前空間も含まれ、クリアされるまで LOOM_EXTRACTION_POLICY_MAX_NAMESPACES に数えられます。 |

<a id="extraction_policyget"></a>

## `extraction_policy.get`

スコープのポリシーと、そのスコープでの抽出が従うポリシーを返します。

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

| 入力フィールド | 型 | デフォルト | 説明 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `scope` | `Literal['org', 'namespace']` | 必須 | `org` は org 自身のポリシーを読み取ります。`namespace` は `namespace` のポリシーを読み取ります。 |
| `namespace` | `str` | `''` | ポリシーを読み取る名前空間。scope が `org` の場合は無視されます。 |

| 出力フィールド | 型 | 説明 |
| --- | --- | --- |
| `org` | `str` | テナント（ID タプルの最初の要素）。 |
| `scope` | `Literal['org', 'namespace']` | 指定どおりの `org` または `namespace`。 |
| `namespace` | `str` | scope が `namespace` の場合の名前空間。scope が `org` の場合は ""。 |
| `policy` | `str` | このスコープのポリシー。未設定の場合は ""。 |
| `updated_by` | `str` | 設定した主体。未設定の場合は ""。 |
| `updated_at` | `datetime \| None` | 設定された日時（UTC）。未設定の場合は None。 |
| `effective` | `str` | このスコープでの抽出が従うポリシー。org のポリシー、続いて名前空間のポリシーの順に適用されます。どちらも未設定の場合は ""。 |
| `namespace_policies` | `list[NamespacePolicy]` | scope が `org` の場合：独自のポリシーを持つ org 内のすべての名前空間を名前で列挙します。削除済みの名前空間も含まれ、クリアされるまで LOOM_EXTRACTION_POLICY_MAX_NAMESPACES に数えられます。 |

<a id="extraction_policyset"></a>

## `extraction_policy.set`

スコープのポリシーを設定し、それまでのポリシーを置き換えます。

`POST /v1/extraction_policy.set` · MCP `loom_extraction_policy_set` · ロール `org_admin` · 冪等 · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 説明 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `scope` | `Literal['org', 'namespace']` | 必須 | `org` は org 自身のポリシーを設定し、すべての名前空間がそれに従います（`namespace` は無視されます）。`namespace` はその名前空間が org のポリシーに追加するルールを設定します。 |
| `namespace` | `str` | `''` | `namespace` スコープのポリシーの対象となる名前空間。scope が `org` の場合は無視されます。 |
| `policy` | `str` | 必須 | 平易な言葉で書かれたルール。最大 4,096 文字で、スコープのポリシーを置き換えます。 |

| 出力フィールド | 型 | 説明 |
| --- | --- | --- |
| `org` | `str` | テナント（ID タプルの最初の要素）。 |
| `scope` | `Literal['org', 'namespace']` | 指定どおりの `org` または `namespace`。 |
| `namespace` | `str` | scope が `namespace` の場合の名前空間。scope が `org` の場合は ""。 |
| `policy` | `str` | このスコープのポリシー。未設定の場合は ""。 |
| `updated_by` | `str` | 設定した主体。未設定の場合は ""。 |
| `updated_at` | `datetime \| None` | 設定された日時（UTC）。未設定の場合は None。 |
| `effective` | `str` | このスコープでの抽出が従うポリシー。org のポリシー、続いて名前空間のポリシーの順に適用されます。どちらも未設定の場合は ""。 |
| `namespace_policies` | `list[NamespacePolicy]` | scope が `org` の場合：独自のポリシーを持つ org 内のすべての名前空間を名前で列挙します。削除済みの名前空間も含まれ、クリアされるまで LOOM_EXTRACTION_POLICY_MAX_NAMESPACES に数えられます。 |

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