Skip to content

The DNSPolicy Custom Resource Definition (CRD)

DNSPolicy

Field Type Required Description
spec DNSPolicySpec Yes The specification for DNSPolicy custom resource
status DNSPolicyStatus No The status for the custom resource

DNSPolicySpec

Field Type Required Description
targetRef Gateway API LocalPolicyTargetReference Yes Reference to a Kubernetes resource that the policy attaches to
healthCheck HealthCheckSpec No HealthCheck spec
loadBalancing LoadBalancingSpec No LoadBalancing Spec
providerRefs ProviderRefs Yes array of references to providers. (currently limited to max 1)

ProviderRefs

Field Type Required Description
providerRefs []ProviderRef Yes max 1 reference. This is an array of providerRef that points to a local secret(s) that contains the required provider auth values

ProviderRef

Field Type Required Description
name String Yes Name of the secret in the same namespace that contains the provider credentials

HealthCheckSpec

Field Type Required Description
endpoint String Yes Endpoint is the path to append to the host to reach the expected health check
port Number Yes Port to connect to the host on
protocol String Yes Protocol to use when connecting to the host, valid values are "HTTP" or "HTTPS"
failureThreshold Number Yes FailureThreshold is a limit of consecutive failures that must occur for a host to be considered unhealthy

LoadBalancingSpec

Field Type Required Description
defaultGeo Boolean Yes Specifies if this is the default geo
geo String Yes Geo value to apply to geo endpoints
weight Number No Weight value to apply to weighted endpoints default: 120

DNSPolicyStatus

Field Type Description
observedGeneration String Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec.
conditions []Kubernetes meta/v1.Condition List of conditions that define that status of the resource.
healthCheck HealthCheckStatus HealthCheck status.
recordConditions [String][]Kubernetes meta/v1.Condition Status of individual DNSRecords owned by this policy.

HealthCheckStatus

Field Type Description
conditions []Kubernetes meta/v1.Condition List of conditions that define that status of the resource.