CLI reference / placement / move

stado placement move

Invocation

stado placement move [OPTIONS] --to-host <TO_HOST> [SERVICES]...

Purpose

Relocate one complete service group to another registered host, or, with --authority, take the registry authority role on --to-host while the declared authority does not answer

Required inputs and options

Input or optionContract
--to-host <TO_HOST>Registered destination host
--authorityTake the registry authority role on --to-host, run on that host: promote its last-known-good registry under the next directory generation, write it into the store it reads, and hand it to every other registered host. Refused while the authority answers
--jsonEmit the committed transaction 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

  • Refused while the authority answers
  • 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.