SetNodeIdleExpiry

Per-node override of the empty-node grace, 0 to clear. Persisted, so a node deliberately kept warm is not reaped after a Manager restart.

Request Type: SetNodeIdleExpiryRequest

Per-node override of the daemon-wide empty-node grace. The reaper terminates an elastic node that has held no job for the grace period; this makes one node’s grace differ, which is what lets a node vacated by a handover linger long enough to migrate BACK onto, and lets a pre-warmed spare outlive the default.

ZERO means "no override — use the daemon-wide value", so clearing an override and never having set one are the same state. The value is daemon-owned and persisted: it survives a Manager restart, because a restart is exactly when a node that was deliberately kept alive would otherwise be reaped out from under an operator.

Field

Type

Repeated

Description

node_id

NodeId

idle_expiry_ms

uint32

uint32: a grace, not a timestamp. The ~49-day ceiling is far beyond any linger worth setting, and it keeps the value a plain number in every generated binding rather than a bigint the UI has to unwrap.

Response Type: Empty