`ezpz incidents`⚓︎

List IRI incidents — maintenance windows, outages, and other facility events. Backed by GET /status/incidents.

ezpz incidents
ezpz incidents --resource aurora
ezpz incidents --status down --limit 50

Incidents are public / unauthenticated: the command works with or without an IRI token. If a token is available (via alcf-tokens or ALCF_IRI_TOKEN) it is sent, otherwise the request is made anonymously.

Options⚓︎

Flag	Description
`--resource NAME`	Filter to a resource (name like `aurora`/`polaris` or a UUID).
`--status {up,down,degraded,unknown}`	Filter by resource status at incident time
`--json`	Emit raw JSON instead of a table
`--limit N`	Max incidents to request (default: `20`)

When --resource is a friendly name (no - in it), ezpz tries to match it against the resource_id of returned incidents. UUIDs are passed through as-is to the API's resource_id query parameter.

Examples⚓︎

All recent incidents⚓︎

ezpz incidents

On a TTY a colour-coded rich table is shown (down red, degraded yellow, up green):

Name                     Status    Type          Time
Aurora maintenance       down      maintenance   2026-04-10 02:00
Polaris drain            degraded  outage        2026-04-09 18:30

Piped/plain output is space-aligned with a header line:

ezpz incidents | cat
# NAME                                     STATUS     TYPE         TIME
# Aurora maintenance                       down       maintenance  2026-04-10 02:00

Filter to one resource⚓︎

ezpz incidents --resource aurora
ezpz incidents --resource 55c1c993-1124-47f9-b823-514ba3849a9a   # by UUID

Find a resource's UUID

ezpz resources --json | jq -r '.[] | "\(.name)\t\(.id)"'

Only outages⚓︎

ezpz incidents --status down
ezpz incidents --status degraded --limit 100

Machine-readable⚓︎

ezpz incidents --json | jq .
ezpz incidents --resource aurora --json | jq 'length'

Check before submitting⚓︎

A quick pre-flight before a large allocation:

ezpz incidents --resource aurora --status down | head
# if empty, no blocking incidents are recorded

ezpz incidents⚓︎