stado placement evict
Invocation
stado placement evict [OPTIONS] --host <HOST> <SERVICE>Purpose
Stop an instance running where the directory places nothing. `doctor`'s placement row tells the operator to end exactly this, and until now no command could: `service stop` refuses a host that declares no such unit, which is the definition of the squatter it is asked to remove. The port comes from the directory, so an instance can only be evicted from a host the directory does NOT place it on.
Required inputs and options
| Input or option | Contract |
|---|---|
<SERVICE> | Logical service the directory declares |
--host <HOST> | Registered host holding the port it should not hold |
--json | Emit the eviction report as JSON |
Output and state effect
It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.
Refusals
- Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.