CLI reference / service / directory / consumer / add

stado service directory consumer add

Invocation

stado service directory consumer add [OPTIONS] <NAME> <CONSUMER>

Purpose

Declare that a consumer may use a service

Required inputs and options

Input or optionContract
<NAME>Service name as the directory keys it
<CONSUMER>Consumer identity to declare
--capability <CAPABILITIES>Capability to grant; repeat for several
--target <TARGET>Host whose existing resolver will carry this consumer's route. The host hands out the loopback port; a consumer it already routes keeps the address it has unless --reassign is given
--reassignGive the consumer's existing adapter on --target a port that host hands out now, replacing the address it had; other hosts' adapters for the consumer stay as they are
--jsonCommand option; required or optional as shown in the invocation.

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

  • The host hands out the loopback port; a consumer it already routes keeps the address it has unless --reassign is given
  • 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.