opschain maintenance list
maintenance
opschain maintenance list [--ended] [--since 24h] [--wide]
Lists maintenance windows across the whole estate (v2
MaintenanceService.ListMaintenanceWindows):
active and scheduled windows by default, recent history too with
--ended. This is the estate-wide view; opschain maintenance status
answers for one node.
The table is
NODE STATE REASON STARTED BY STARTED/FROM UNTIL/TO ALLOW DEFERRED.
STATE is scheduled, active or ended; STARTED/FROM is the activation
time (or the declared start while still scheduled); UNTIL/TO is the hard
end of a scheduled window or the advisory until of a manual one; ALLOW
flattens the three allow lists into one cell, truncated at 40 characters
unless --wide; DEFERRED is the window's live parked-firing count.
An empty estate prints no maintenance windows and exits 0. -o json /
-o yaml emit the window documents verbatim.
Flags
| Flag | Meaning |
|---|---|
--ended | Also list ended windows. |
--since <d> | With --ended, only windows ended within this duration (e.g. 24h). |
--wide | Untruncated ALLOW column. |
--filter <column>[!]=<value> | Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased (spaces/dashes fold to _); * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Applied client-side; --ended and --since select the fetched set server-side. Grammar: opschain docs cli. |
Exit codes
| Code | Meaning |
|---|---|
| 0 | Listed. |
| 1 | The lookup failed — server, auth or decode error. |
| 2 | Usage error, including a missing server target. |
Named errors
--since only applies together with --ended— exit 2.--since wants a duration like 24h or 30m: <parse error>— exit 2.
Examples
opschain maintenance list
opschain maintenance list --ended --since 24h --wide
See also
opschain docs cli/maintenance-status— one node, in full.opschain learn 5.6— the maintenance-window runbook.