CLI reference / dns / set

stado dns set

Invocation

stado dns set [OPTIONS] --type <TYPE> --value <VALUE> <NAME>

Purpose

Add or replace one record, preserving every other record in the zone. The zone is read, the one name and type are replaced, and the whole list is written back. The write is verified by reading the zone again; a record that is not visible afterwards is a failure, not a warning.

Required inputs and options

Input or optionContract
<NAME>Fully qualified name, for example preferences.wisent.com
--type <TYPE>Record type: A, AAAA, CNAME, TXT or ALIAS
--value <VALUE>Record value: an address for A/AAAA, a target for CNAME/ALIAS
--ttl <TTL>Record TTL in seconds [default: 1800]
--zone <ZONE>Zone name; defaults to the last two labels of the name
--checkReport what would change and exit non-zero, without writing
--credential <CREDENTIAL>Skarbiec item holding api_user, api_key, username and client_ip [default: namecheap_auto]
--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

  • Report what would change and exit non-zero, without writing
  • 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.