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
| API | dns.etorm.com/v1alpha1 |
| Resource | dnsrecords (cluster-scoped inside its cluster) |
| Short names | rr |
| Available in | the platform only |
| Status | written 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
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
zoneRef | object | yes | The DNSZone this record belongs to. | ||
zoneRef.name | string | yes | length 1 to 63 | Name of the DNSZone. | |
type | string (one of) | yes | A, AAAA, CNAME, TXT, MX, NS, CAA, SRV, HTTPS | The record type. A, AAAA, CNAME and TXT are written by the operator; the others are inventoried and watched. | |
name | string | yes | length 1 to 253 | Relative to the zone, or the full name; @ is the apex. | |
content | string | up to 2048 characters | The record's content. | ||
ttl | integer | 1 | at least 1 | Seconds; 1 means automatic. | |
proxied | boolean | false | Served through the provider's proxy (A, AAAA and CNAME only). | ||
priority | integer | at least 0 | MX and SRV priority. | ||
data | object (free-form) | Structured content of types the operator only watches (CAA, SRV, HTTPS), as the provider reports it. | |||
comment | string | up to 512 characters | Free text kept with the record. | ||
mode | string (one of) | plan, apply | Overrides the zone's mode for this record. | ||
owner | object | Who 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.kind | string (one of) | "DNSRecord" | DNSRecord, PublicRecord, PublicEndpoint | The owner's kind. | |
owner.name | string | up to 63 characters | The owner's name (not for DNSRecord). |
Status
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
phase | string (one of) | Pending, Synced, Planned, Drifted, Missing, Protected, Unsupported, NotOwned, Failed | Where the record stands. | ||
observedGeneration | integer | The generation of the spec this status describes. | |||
providerId | string | The provider's identifier of the record. | |||
observed | object | The record as the provider has it. | |||
observed.content | string | Its content. | |||
observed.ttl | integer | Its ttl. | |||
observed.proxied | boolean | Whether it is proxied. | |||
plan | object | What apply mode would do. | |||
plan.action | string | create or repair. | |||
plan.message | string | In a sentence. | |||
message | string | Why it failed or is not written. | |||
conditions | list of object | Ready. | |||
conditions[].type | string | Ready. | |||
conditions[].status | string | True, False or Unknown. |
Columns in listings
| Column | From |
|---|---|
| Zone | .spec.zoneRef.name |
| Type | .spec.type |
| Name | .spec.name |
| Content | .spec.content |
| Owner | .spec.owner.kind |
| Phase | .status.phase |