diff --git a/docs/Config_params/CONFIG_PARAMS.de.md b/docs/Config_params/CONFIG_PARAMS.de.md index 18c7eb6..3b609f0 100644 --- a/docs/Config_params/CONFIG_PARAMS.de.md +++ b/docs/Config_params/CONFIG_PARAMS.de.md @@ -2228,10 +2228,23 @@ Generationsreload übernimmt `whitelist`, `gray_action`, `auth_header`, `enabled`, `listen` und `runtime_edge_events_capacity` erfordern einen Neustart des Prozesses. -Ändern Sie die zuständige TOML-Datei und rufen Sie für Felder, die ein -Generationsreload übernehmen kann, `POST /v1/system/reload` auf. -`PATCH /v1/config` erlaubt unter `server` derzeit nur `server.listeners` und -kann `server.api.*` nicht ändern. `GET /v1/config/schema` beschreibt für jedes +`GET /v1/config`, `PATCH /v1/config` und `POST /v1/config/validate` stellen unter +`server.api` nur `minimal_runtime_enabled`, `minimal_runtime_cache_ttl_ms`, +`runtime_edge_enabled`, `runtime_edge_cache_ttl_ms` und `runtime_edge_top_n` +bereit, zusätzlich zu `server.listeners`. GET enthält die Standardwerte; +PATCH erhält benachbarte API-Einstellungen. Beide TTLs erlauben `0..60000` ms +(`0` deaktiviert das Caching), top-N erlaubt `1..1000`. Ausgelassene Felder und +zulässige Felder mit `null` behalten ihre Werte. Verbotene Felder werden auch +bei `null` abgelehnt. Ein server-Patch ohne konkreten bearbeitbaren Wert wird +abgelehnt. Speichern allein aktiviert diese Einstellungen nicht: Verwenden Sie +`?reload=instant`, `?reload=drain` oder `POST /v1/system/reload` und warten Sie +auf die Aktivierung der Generation. Auch bei gemischten Änderungen behält der +Dateiwächter die bisherigen Werte bei. API-Listener und Ereignispufferkapazität +bleiben an den Prozess gebunden; verspätete Cache-Schreibvorgänge können einer +Anfrage keine Daten einer anderen Generation liefern. Andere API-Einstellungen +müssen weiterhin in der zuständigen TOML-Datei geändert werden. Siehe +[API-Diagnoseeinstellungen](../Architecture/API/API.md#api-observability-settings). +`GET /v1/config/schema` beschreibt für jedes Feld die API-Verfügbarkeit und das Übernahmeverhalten. `GET /v1/config/state` zeigt Unterschiede zwischen Sollzustand und veröffentlichtem Zustand, ohne zu bestätigen, dass alle Verbraucher die Einstellungen bereits übernommen haben. diff --git a/docs/Config_params/CONFIG_PARAMS.en.md b/docs/Config_params/CONFIG_PARAMS.en.md index 28929b6..581a99b 100644 --- a/docs/Config_params/CONFIG_PARAMS.en.md +++ b/docs/Config_params/CONFIG_PARAMS.en.md @@ -2227,9 +2227,19 @@ active API settings. Explicit generation reload applies `whitelist`, `read_only`. `enabled`, `listen`, and `runtime_edge_events_capacity` require a process restart. -Edit the owning TOML source, then use `POST /v1/system/reload` for fields that a -generation reload can apply. `PATCH /v1/config` currently permits only -`server.listeners` under `server`; it cannot write `server.api.*`. +`GET /v1/config`, `PATCH /v1/config`, and `POST /v1/config/validate` expose only +`minimal_runtime_enabled`, `minimal_runtime_cache_ttl_ms`, `runtime_edge_enabled`, +`runtime_edge_cache_ttl_ms`, and `runtime_edge_top_n` under `server.api`, alongside +`server.listeners`. GET includes defaults; sparse PATCH preserves API siblings. +Both TTLs accept `0..60000` ms (`0` disables caching); top-N accepts `1..1000`. +Omission and allowed `null` members retain values. Forbidden fields are rejected +even when `null`. A server patch without a concrete editable value is rejected. +Saving alone leaves these settings pending: use `?reload=instant`, `?reload=drain`, +or `POST /v1/system/reload` and wait for activation. The watcher retains them even +in mixed changes. The API listener and event-ring capacity remain process-owned; +late cache writes cannot cross request-generation boundaries. Other API settings +still require editing the owning TOML source. See +[API observability settings](../Architecture/API/API.md#api-observability-settings). `GET /v1/config/schema` describes each field's exposure and application policy. `GET /v1/config/state` reports desired/published differences without claiming complete consumer convergence. See the [API reference](../Architecture/API/API.md) diff --git a/docs/Config_params/CONFIG_PARAMS.ru.md b/docs/Config_params/CONFIG_PARAMS.ru.md index f8e1646..0e8aa97 100644 --- a/docs/Config_params/CONFIG_PARAMS.ru.md +++ b/docs/Config_params/CONFIG_PARAMS.ru.md @@ -2233,10 +2233,22 @@ `read_only`. Для `enabled`, `listen` и `runtime_edge_events_capacity` нужен перезапуск процесса. -Измените TOML-файл, которому принадлежит настройка, затем вызовите -`POST /v1/system/reload` для полей, применяемых через reload поколения. -`PATCH /v1/config` сейчас допускает только `server.listeners` внутри `server` -и не позволяет менять `server.api.*`. `GET /v1/config/schema` описывает +`GET /v1/config`, `PATCH /v1/config` и `POST /v1/config/validate` открывают внутри +`server.api` только `minimal_runtime_enabled`, `minimal_runtime_cache_ttl_ms`, +`runtime_edge_enabled`, `runtime_edge_cache_ttl_ms` и `runtime_edge_top_n`, +в дополнение к `server.listeners`. GET включает значения по умолчанию; PATCH +сохраняет соседние настройки API. Оба TTL допускают `0..60000` мс (`0` отключает +кэширование), top-N — `1..1000`. Пропущенные поля и допустимые поля со значением +`null` сохраняют прежние значения. Запрещённые поля отклоняются даже при `null`. +PATCH объекта server без конкретного редактируемого значения отклоняется. +Одного сохранения недостаточно: используйте `?reload=instant`, `?reload=drain` +или `POST /v1/system/reload` и дождитесь активации поколения. Watcher сохраняет +прежние значения этих полей даже при смешанных изменениях. Listener API и ёмкость +кольцевого буфера событий остаются общими для процесса; поздняя запись в кэш +не позволяет выдать запросу данные другого поколения. Остальные настройки API +по-прежнему меняются в TOML-файле-владельце. См. +[настройки диагностики API](../Architecture/API/API.md#api-observability-settings). +`GET /v1/config/schema` описывает доступность и способ применения каждого поля. `GET /v1/config/state` показывает различия между желаемым и опубликованным состоянием, без обещания, что все потребители уже применили настройки. См. [справочник API](../Architecture/API/API.md)