dnspolicy.md

The DNSPolicy Custom Resource Definition (CRD)

• DNSPolicy
• DNSPolicySpec
  • ProviderRefs
  • HealthCheckSpec
  • LoadBalancingSpec
    • LoadBalancingWeighted
      • CustomWeight
    • LoadBalancingGeo
• DNSPolicyStatus
  • HealthCheckStatus

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.