CLI reference / scratch / create

stado scratch create

Invocation

stado scratch create [OPTIONS] --host <HOST> --profile <PROFILE>

Purpose

Lease a disposable target on HOST, and prove it can be entered

Required inputs and options

Input or optionContract
--host <HOST>Registry target the lease is taken on
--profile <PROFILE>Profile name from stado-rs/data/scratch-profiles.json
--name <NAME>Lease name, which is also the account name. Generated when omitted
--ttl <TTL>Lifetime, in minutes or hours (90m, 2h). The profile's default when omitted, refused above its maximum
--root <ROOT>Directory the emitted registry is written to. Refused when it already exists
--jsonEmit the lease 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

  • The profile's default when omitted, refused above its maximum
  • Refused when it already exists
  • 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.