Config Parameters synced

This commit is contained in:
Alexey
2026-11-07 23:06:12 +03:00
parent c42ef876be
commit 82baf0dda4
3 changed files with 46 additions and 11 deletions
+16 -4
View File
@@ -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)