Stado

CLI reference / artifact / alias / remove

stado artifact alias remove

Invocation

stado artifact alias remove [OPTIONS] --expected-target <EXPECTED_TARGET> <ALIAS_REF>

Purpose

Delete an alias while it still targets --expected-target; the versions it pointed at stay. An absent alias is reported, not refused

Required inputs and options

Input or optionContract
<ALIAS_REF>The alias as a reference whose version part is the alias name
--expected-target <EXPECTED_TARGET>The version the alias must still target for the removal to happen
--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 version the alias must still target for the removal to happen
  • 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.