Domain

API resource reference for Domain, part of the Networking service. To create or change one, see Changing resources; to read or inspect, see Reading resources. For the underlying concept, see Domains & DNS.

The networking.datumapis.com/v1alpha API is alpha and subject to change. Fields and behavior may change in future releases.

Identity


Group	`networking.datumapis.com`
Version	`v1alpha`
Kind	`Domain`
Scope	Project

Overview

A Domain represents a fully qualified domain name (FQDN) that Datum Cloud manages on your behalf. You create a Domain to bring a domain under management so that Datum can track its registration and verification status and discover its authoritative nameservers. Each Domain lives in a Project.

Spec fields

Field	Type	Required	Description
`spec.domainName`	string	Yes	The fully qualified domain name (FQDN) to be managed.
`spec.desiredRegistrationRefreshAttempt`	string	No	The desired time of the next registration refresh attempt.

Status fields (read-only)

Field	Type	Description
`status.apex`	boolean	True when `spec.domainName` is the registered domain (eTLD+1).
`status.conditions`	[]Object	Conditions describing the current state of the Domain.
`status.nameservers`	[]Object	The authoritative NS for the effective domain name. If `apex` is true, taken from RDAP for the registered domain (eTLD+1); if false, taken from DNS delegation for the subdomain, falling back to apex NS if there is no cut.
`status.registration`	Object	Registration information for the domain.
`status.verification`	Object	Verification status of the domain.

Usage

apiVersion: networking.datumapis.com/v1alpha
kind: Domain
metadata:
  name: example-com
spec:
  domainName: example.com

# Create or update the Domain
datumctl apply -f domain.yaml --project my-project

# List Domains in the project
datumctl get domains --project my-project

# Inspect a single Domain
datumctl describe domain example-com --project my-project

Run datumctl explain domains --recursive to see the full, live field tree for this resource.

Last modified on July 2, 2026

⌘I

Overview

Concepts

Resource Manager

IAM

Compute

Networking

DNS

IPAM

Quota

Billing

Telemetry

Notification

Platform resources

Identity

Overview

Spec fields

Status fields (read-only)

Usage

​Identity

​Overview

​Spec fields

​Status fields (read-only)

​Usage

Identity

Overview

Spec fields

Status fields (read-only)

Usage