Route 53 · Operations

Route53HostedZone

Manage public and private DNS hosted zones.

Generic driverUniform lifecycle
Scope
Global
Spec fields
4
Outputs
5
Lookup
Supported

Resource definition

What this resource looks like

This is the CUE shape a Praxis template uses to declare a Route53HostedZone. The resource key is local to the template; metadata.name supplies its stable Praxis identity.

CUE example
resources: zone: {
  apiVersion: "praxis.io/alpha"
  kind: "Route53HostedZone"
  metadata: {name: "example.com", labels: {}}
  spec: {
    comment: "Production DNS"
    tags: environment: "prod"
  }
}
Complete examples in the repository

Desired state

Configuration

The spec block accepts 4 fields. 0 are required by the schema; fields with defaults can be omitted.

isPrivateOptional

Is Private.

bool | *false
BooleanDefault false
commentOptional

Comment.

string
String
vpcsOptional

Vpcs.

[...{ vpcId: string vpcRegion: string }]
Object list
tagsOptional

Tags.

[string]: string
Map

Observed values

Outputs

Praxis records these values after observation. A dependent resource can read one with ${resources.<name>.outputs.<field>}.

hostedZoneIdString
nameString
nameServersList · optional
isPrivateBoolean
recordCountInteger

Read without ownership

Data-source lookup

A data block reads an existing Route53HostedZone and exposes its outputs without storing lifecycle state. The generic filter surface accepts id, name, and tag; supported combinations depend on the AWS identity used by this resource.

CUE data source
data: existing: {
  kind: "Route53HostedZone"
  filter: {
    name: "replace-with-provider-name"
  }
}
Documented selectorsidnametag

Understand data sources and filters →

Adopt existing infrastructure

Import

Import persists Praxis state for an existing AWS resource. For this kind, supply: Hosted zone ID, for example Z0123456789ABCDEF. The example starts in observed mode so Praxis reports drift without correcting it.

CLI
praxis import Route53HostedZone \
  --id <provider-identifier> \
  --account production \
  --observe

Choose managed or observed ownership →

Canonical contract

Complete CUE schema

The field guide above is derived from this definition. The schema remains the source of truth for accepted values, defaults, validation constraints, and outputs in the current alpha revision.

Show the complete schema
schemas/aws/route53/hosted_zone.cue
package route53

#Route53HostedZone: {
	apiVersion: "praxis.io/alpha"
	kind:       "Route53HostedZone"

	metadata: {
		name: string & =~"^[A-Za-z0-9][A-Za-z0-9.-]{0,253}[A-Za-z0-9]$"
		labels: [string]: string
	}

	spec: {
		isPrivate?: bool | *false
		comment?:   string
		vpcs?: [...{
			vpcId:     string
			vpcRegion: string
		}]
		tags?: [string]: string
	}

	outputs?: {
		hostedZoneId: string
		name:         string
		nameServers?: [...string]
		isPrivate:   bool
		recordCount: int
	}
}

View this schema on GitHub →