hcloud-dns

Hetzner Cloud DNS

Zone Lifecycle

Create a Zone

hcloud zone create [options] --name <name>

Flags:

• --name <name> - Zone name / domain (required)
• --ttl <seconds> - Default Time To Live (TTL) of the Zone
• --mode <mode> - Mode of the Zone: primary, secondary (default: primary)
• --zonefile <file> - Zone file in BIND (RFC 1034/1035) format (use - to read from stdin)
• --primary-nameservers-file <file> - JSON file containing primary nameservers (for secondary zones)
• --label <key=value> - User-defined labels (can be specified multiple times)
• --enable-protection <delete> - Enable protection (default: none)
• -o, --output json|yaml - Output format

List Zones

hcloud zone list [options]

Columns: id, name, name_idna, status, ttl, mode, authoritative_nameservers, primary_nameservers, registrar, record_count, age, created, labels, protection

Flags:

• --mode <mode> - Filter by zone mode
• -l, --selector <label> - Filter by label selector
• -s, --sort <field> - Sort results
• -o, --output noheader|columns=...|json|yaml - Output options

Describe a Zone

hcloud zone describe [options] <zone>

Flags:

• -o, --output json|yaml|format - Output format

Delete Zones

hcloud zone delete <zone>...

Accepts one or more zone IDs or names.

Zone Configuration

Change Default TTL

hcloud zone change-ttl --ttl <seconds> <zone>

Flags:

• --ttl <seconds> - Default Time To Live (TTL) of the Zone (required, default: 3600)

Change Primary Nameservers

hcloud zone change-primary-nameservers --primary-nameservers-file <file> <zone>

Changes the primary nameservers of a secondary Zone.

Flags:

• --primary-nameservers-file <file> - JSON file containing the new primary nameservers (use - to read from stdin)

The input file must be JSON. Example:

[
  { "address": "203.0.113.10" },
  { "address": "203.0.113.11", "port": 5353 },
  { "address": "203.0.113.12", "tsig_algorithm": "hmac-sha256", "tsig_key": "example-key" }
]