v18

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-08-0569400504.8 KB

Quotas

Set global quotas

Replace the cluster-wide resource quota configuration. The new configuration is propagated to every peer through consensus and persisted, so it survives restarts

put/quotas

Query parameters

waitboolean

If true, wait until the new configuration is confirmed by consensus on this peer. If false - the request returns as soon as the change is proposed.

Request body

enabledboolean

Whether the limits below are enforced.

max_resident_memory_percentinteger nullable

Reject memory-consuming updates once process resident memory reaches this percentage of total system memory (or of the cgroup limit, if one applies).

max_disk_usage_percentinteger nullable

Reject disk-consuming updates once the filesystem hosting the storage directory is filled to this percentage of its capacity.

release_margin_percentinteger nullable

How many percentage points below its limit a resource has to fall before this node starts accepting work again.

Without a margin, a resource resting on its limit crosses it in both directions on the noise between two readings, putting the node in and out of service each time — and restarting a shard recovery with it. Raise it where usage is volatile; 0 disables the margin and releases as soon as usage is back under the limit.

Unset leaves the built-in default in force, so a config written today does not pin a number that a later release may want to revise.

Response

successful operation

timenumber float

Time spent to process this request

statusstring

resultboolean

Example response

{
  "time": 0.002,
  "status": "ok"
}