Skip to main content
Version: v5.6.1

opschain maintenance cancel

maintenance

opschain maintenance cancel <path> --window <id>

Removes a scheduled maintenance window that has not started yet — nothing was ever quiesced, so nothing is released. A window that is already running cannot be cancelled; end it with opschain maintenance end.

The window id comes from the output of opschain maintenance schedule, or from opschain maintenance status / opschain maintenance list. Prints cancelled scheduled maintenance on <path> (window <id>); -o json / -o yaml emit the cancelled window document.

Flags​

FlagMeaning
--window <id>The scheduled window id to cancel. Required.

Exit codes​

CodeMeaning
0Window cancelled.
1The server refused — e.g. the window already started, or the id names no scheduled window on this node.
2Usage error.

Named errors​

  • required flag(s) "window" not set — exit 2.
  • expected a node path like demo/environments/dev, got "" — exit 2.

Example​

opschain maintenance cancel acme/environments/prod --window 01999a7e-…
cancelled scheduled maintenance on /projects/acme/environments/prod (window 01999a7e-…)

See also​

  • opschain docs cli/maintenance-schedule — what you are cancelling.
  • opschain docs cli/maintenance-end — for a window already running.