Resources / DNSRecord

DNSRecord

One DNS record of a zone, as desired state (spec 0051). Made by hand or by the manifest of the zone, or by the zone's inventory (in plan mode) for a record that already existed.

Overview

APIdns.etorm.com/v1alpha1
Resourcednsrecords (cluster-scoped inside its cluster)
Short namesrr
Available inthe platform only
Statuswritten by a controller through /status

Minimal example

apiVersion: dns.etorm.com/v1alpha1
kind: DNSRecord
metadata:
  name: example
spec:
  zoneRef:
    name: "<name>"
  type: A
  name: "<name>"

Spec

FieldTypeRequiredDefaultAllowedDescription
zoneRefobjectyesThe DNSZone this record belongs to.
zoneRef.namestringyeslength 1 to 63Name of the DNSZone.
typestring (one of)yesA, AAAA, CNAME, TXT, MX, NS, CAA, SRV, HTTPSThe record type. A, AAAA, CNAME and TXT are written by the operator; the others are inventoried and watched.
namestringyeslength 1 to 253Relative to the zone, or the full name; @ is the apex.
contentstringup to 2048 charactersThe record's content.
ttlinteger1at least 1Seconds; 1 means automatic.
proxiedbooleanfalseServed through the provider's proxy (A, AAAA and CNAME only).
priorityintegerat least 0MX and SRV priority.
dataobject (free-form)Structured content of types the operator only watches (CAA, SRV, HTTPS), as the provider reports it.
commentstringup to 512 charactersFree text kept with the record.
modestring (one of)plan, applyOverrides the zone's mode for this record.
ownerobjectWho writes the record. DNSRecord (default): the zone operator. Another kind: the record belongs to that object's operator and is mirrored here read-only (one writer per record).
owner.kindstring (one of)"DNSRecord"DNSRecord, PublicRecord, PublicEndpointThe owner's kind.
owner.namestringup to 63 charactersThe owner's name (not for DNSRecord).

Status

FieldTypeRequiredDefaultAllowedDescription
phasestring (one of)Pending, Synced, Planned, Drifted, Missing, Protected, Unsupported, NotOwned, FailedWhere the record stands.
observedGenerationintegerThe generation of the spec this status describes.
providerIdstringThe provider's identifier of the record.
observedobjectThe record as the provider has it.
observed.contentstringIts content.
observed.ttlintegerIts ttl.
observed.proxiedbooleanWhether it is proxied.
planobjectWhat apply mode would do.
plan.actionstringcreate or repair.
plan.messagestringIn a sentence.
messagestringWhy it failed or is not written.
conditionslist of objectReady.
conditions[].typestringReady.
conditions[].statusstringTrue, False or Unknown.

Columns in listings

ColumnFrom
Zone.spec.zoneRef.name
Type.spec.type
Name.spec.name
Content.spec.content
Owner.spec.owner.kind
Phase.status.phase

All resources