CLI reference / web / schedule / set

stado web schedule set

Invocation

stado web schedule set [OPTIONS] --path <PATH> --method <METHOD> --cron <CRON> --tz <TZ> <PRODUCT> <NAME>

Purpose

Declare or change one scheduled request of a web product

Required inputs and options

Input or optionContract
<PRODUCT>Web product name
<NAME>Schedule name, canonical (lowercase letters, digits, dashes)
--path <PATH>Request path on the unit, starting with `/`
--method <METHOD>HTTP method, upper case
--cron <CRON>5-field cron expression
--tz <TZ>IANA time zone the cron is read in
--secret-header <SECRET_HEADER>Header that carries the secret, e.g. `authorization`
--secret <SECRET>`role#field` whose value the header carries
--secret-scheme <SECRET_SCHEME>Scheme written before the value, e.g. `Bearer`
--jsonEmit machine-readable output

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.