Expand description
What the admin API and the rws binary’s MCP tools both do, as JSON.
One implementation, so the two can’t drift apart.
State that belongs to an application rather than the process (its
response cache, its route table) is registered here by whoever builds
the application (register_cache, register_routes).
Functions§
- block
- blocklist_
json - build_
features_ json - Compile-time features as
{"name":bool}. - cache_
stats_ json - certificates_
json - The certificates served, soonest expiry first, and the ACME renewal loop’s state.
- check_
rate_ limit_ json ip’s remaining quota under the global limit; counts as one request.- clear_
registered_ cache - Clear the registered cache;
falsewithout one. - config_
json - Every
RWS_CONFIG_*setting in effect, sorted; secrets (names withSECRET,PASSWORDorTOKEN) shown as(hidden). - cors_
json - flags_
json - Runtime feature flags (
crate::feature). - logs_
json - The last
naccess-log lines (at mostcrate::log::tail::CAPACITY), oldest first, each as a string. - maintenance_
json - metrics_
json - The server’s counters.
- rate_
limit_ json - recent_
json - The last
nrequests (at most 100), or the lastnwith a 4xx/5xx status. - register_
cache - The response cache the admin API reports on and clears (a clone shares the store).
- register_
routes - The application’s routes as
(method, pattern), for listing. - registered_
cache_ json - Stats of the registered cache;
Nonewithout one. - registered_
routes_ json - request_
renewal - Ask ACME to renew now;
falsewhen it isn’t running. - routes_
json - set_
drained - Drain or undrain
backendofupstream;Errnames what doesn’t exist. - set_
flag - set_
maintenance - unblock
- upstreams_
json - The config file’s upstreams: each backend’s weight, health, breaker state and whether it is drained.