CLI reference

norcube monitor maintenance update

Change a maintenance window, as far as where it stands allows

Not verified yet

Changes only what you pass.

Before the window starts, everything can change; moving a time by 5 minutes or more tells subscribers who were already told. Once it has started, its targets and start are frozen: you can still change the text and the mail switches, and extend or shorten it, which sends no mail. Once it is over, only the text can change. A cancelled window can't change. The API refuses anything else with exit 8.

--monitor, --component and --status-page replace the targets as a whole, so name everything the window should keep. --duration counts from the new --start, or else from the window's current start.

A CI token needs the monitor.maintenance scope, and monitor.statuspages too when the window shows on a published page before or after the change. To end a window now, use "finish"; to call off one that hasn't started, use "cancel".

Usage

norcube monitor maintenance update <window> [flags]

Examples

# The deploy needs longer
norcube monitor maintenance update 4d3c2b1a-0f9e-4d8c-b7a6-5f4e3d2c1b0a --end +1h
norcube monitor maintenance update 4d3c2b1a-0f9e-4d8c-b7a6-5f4e3d2c1b0a --start 2026-11-08T14:00:00Z --duration 2h
norcube monitor maintenance update 4d3c2b1a-0f9e-4d8c-b7a6-5f4e3d2c1b0a --title "Database upgrade" --no-notify

Flags

FlagDefaultDescription
--componentA manual status page component to mark, by id or exact name (repeatable)
--descriptionWhat is happening; public on a published status page and in mail
--durationHow long it lasts, counted from its start: 15m, 2h, 7d (at most 30 days)
--endWhen it ends: an RFC 3339 timestamp, now, or a span from now (+2h, +7d)
--monitorA monitor to hold, by id or exact name (repeatable); domain monitors can't be held
--no-notifyTurn off all three mails; a cancellation still tells whoever was told
--notify-finishedEmail subscribers when it finishes
--notify-scheduledEmail subscribers when it is scheduled
--notify-startedEmail subscribers when it starts
--startMove its start, before it has started: an RFC 3339 timestamp or a span from now (+2h, +7d)
--status-pageEverything a status page shows right now, by id or exact slug (repeatable); something added to the page later isn't included
--titleThe window's title; public on a published status page

Every command also takes the global flags: --profile, --org, -o, --query, --debug and more.

See also

On this page