Manage DNS Record Sets

Overview

Record sets are the DNS entries within a zone that map hostnames to values. Each record set has a type (A, CNAME, MX, etc.), a fully qualified name, a TTL, and one or more values. Record sets are project-scoped through their parent zone.

Prerequisites

An active Polystack account with appropriate permissions
Access to the Polystack Dashboard or CLI configured with credentials
API credentials sourced (source openrc.sh)

A zone must be in Active status before record sets can be created within it. See Create a Zone if you have not yet provisioned a zone.

Create a Record Set

Dashboard
CLI

The Create Record Set form provides dynamic help text and validation based on the selected record type.

Open the zone

Navigate to Network > DNS Zones and click a zone name to open the detail page. Go to the Record Sets tab.Click Create Record Set.

Select the record type

Choose the Type from the dropdown. This selection controls the validation rules and format hints for the Records field.

Type	Description
A	Address Record — maps to IPv4 address
AAAA	IPv6 Address Record
CAA	Certificate Authority Authorization
CNAME	Canonical Name (alias)
MX	Mail Exchange
NS	Name Server delegation
PTR	Pointer Record (reverse DNS)
SOA	Start Of Authority
SPF	Sender Policy Framework
SRV	Service Locator
SSHFP	SSH Public Key Fingerprint
TXT	Text Record

The default selection is A.

The Type field cannot be changed after creation. If you need a different type, delete the record set and create a new one.

Enter the record name

Enter the Name — the fully qualified hostname for this record.

The name must end with a trailing dot (e.g., www.example.com.). Omitting the trailing dot will cause a validation error.

The form shows a format example based on the selected type:

Type	Name Example
A, AAAA, CAA, MX, NS, PTR, SOA, SPF, SSHFP, TXT	`example.com.`
CNAME	`first.example.com.`
SRV	`_sip._tcp.example.com.` (with protocol and service name)

Add a description (optional)

Enter an optional Description for this record set.

Set the TTL

Enter the TTL (Time To Live) in seconds. Default: 3600 (1 hour).This controls how long resolvers cache this record before re-querying.

Add record values

Click the add button in the Records field to add one or more values. At least one record value is required.The form shows format examples and validation rules based on the selected type:

Type	Format Example	Validation
A	`192.168.1.1`	Must be a valid IPv4 address
AAAA	`2001:db8:3333:4444:5555:6666:7777:8888`	Must be a valid IPv6 address
CAA	`0 iodef mailto:security@example.com`	Flag (0-255), tag (issue/issuewild/iodef), value
CNAME	`other-example.com`	Target FQDN
MX	`10 mail.example.com`	Priority number followed by mail server FQDN
NS	`ns1.example.com`	Nameserver FQDN
PTR	`1.1.0.192.in-addr.arpa.`	Reverse FQDN
SOA	`ns1.example.com admin.example.com 2013022001 86400 7200 604800 300`	Primary NS, admin email, serial, refresh, retry, expire, minimum
SPF	`"v=spf1 ipv4=192.1.1.1 include:examplesender.email +all"`	SPF policy string
SRV	`10 0 5060 server1.example.com.`	Priority, weight, port, target FQDN
SSHFP	`4 2 123456789abcdef...`	Algorithm, fingerprint type, hex fingerprint
TXT	(no format hint shown)	Any text string

Add multiple record values for round-robin distribution (e.g., multiple A records for the same hostname). Each value is returned to resolvers in rotating order.

Create the record set

Click Confirm. The record set enters Pending momentarily and then transitions to Active.

Record set appears in the zone’s Record Sets tab with status Active.

Source credentials

source openrc.sh

openstack recordset create \
  --type A \
  --record 192.168.1.10 \
  --record 192.168.1.11 \
  --ttl 3600 \
  example.com. www

openstack recordset create \
  --type AAAA \
  --record 2001:db8::1 \
  --ttl 3600 \
  example.com. www

openstack recordset create \
  --type CNAME \
  --record app.example.com. \
  example.com. api

openstack recordset create \
  --type MX \
  --record "10 mail.example.com." \
  --record "20 mail-backup.example.com." \
  example.com. @

openstack recordset create \
  --type TXT \
  --record '"v=spf1 include:_spf.example.com ~all"' \
  example.com. @

openstack recordset create \
  --type SRV \
  --record "10 20 5060 sip.example.com." \
  example.com. _sip._tcp

openstack recordset create \
  --type CAA \
  --record '0 issue "letsencrypt.org"' \
  example.com. @

openstack recordset create \
  --type NS \
  --record "ns1.partner.com." \
  --record "ns2.partner.com." \
  example.com. sub

View Record Sets

Dashboard
CLI

View the record list

Navigate to a zone’s detail page and go to the Record Sets tab. The list shows:

Column	Description
ID/Name	Record set FQDN (clickable to view details)
Type	Record type with description (e.g., “A - Address Record”)
Records	All values displayed as individual tags
Status	Active, Pending, or Error
Created At	Creation timestamp

Filter records

Use the search/filter bar to narrow the list:

Filter	Options
Name	Text search by record name
Type	Dropdown with all 12 record types
Status	Active, Pending, Error

View record detail

Click a record name to open the detail page showing:

Section	Fields
Summary	Name, Description, Type (with description), Status
Base Info	Action, Records (all values listed), TTL, Version
Modification Times	Created At, Updated At
Associations	Zone ID, Zone Name, Project ID

openstack recordset list example.com.

openstack recordset show example.com. www

Update a Record Set

Dashboard
CLI

Open the update dialog

Navigate to the zone’s Record Sets tab. Click the Update action on the record row, or open the record detail page and click Update.

Edit the record

The Name and Type fields are locked and cannot be changed. You can update:

Description
TTL
Records — add, remove, or modify values

To change a record’s type (e.g., A to AAAA), delete the existing record set and create a new one with the correct type.

Save the update

Click Confirm. The record set enters Pending briefly during the update.

Update record value

openstack recordset set \
  --record 192.168.1.20 \
  example.com. www

Update TTL only

openstack recordset set \
  --ttl 300 \
  example.com. www

Use a low TTL (e.g., 300 seconds) before planned IP changes, then increase it after the change is confirmed stable. This minimizes propagation delay during migrations.

Delete Record Sets

Dashboard
CLI

Select records to delete

Navigate to the zone’s Record Sets tab. Select one or more records using the checkboxes and click Delete in the batch actions bar.Alternatively, click the More menu on a record row and select Delete.

Confirm deletion

Confirm the deletion in the dialog. The confirmation shows both the record name and ID.

Deleting a record set is immediate on the server side. Resolvers that have cached the record will continue returning the value until their cache TTL expires.

Delete a record set

openstack recordset delete example.com. www

Next Steps

Record Types Reference

Detailed reference for every supported record type and its value format

Reverse DNS

Configure PTR records for IP-to-hostname resolution

Troubleshooting

Resolve propagation delays and CNAME conflicts

Create a Zone

Provision a new authoritative zone for a domain

Core Services

Other Services

Overview

Create a Record Set

Open the zone

Select the record type

Enter the record name

Add a description (optional)

Set the TTL

Add record values

Create the record set

View Record Sets

View the record list

Filter records

View record detail

Update a Record Set

Open the update dialog

Edit the record

Save the update

Delete Record Sets

Select records to delete

Confirm deletion

Next Steps

Record Types Reference

Reverse DNS

Troubleshooting

Create a Zone

​Overview

​Create a Record Set

Open the zone

Select the record type

Enter the record name

Add a description (optional)

Set the TTL

Add record values

Create the record set

​View Record Sets

View the record list

Filter records

View record detail

​Update a Record Set

Open the update dialog

Edit the record

Save the update

​Delete Record Sets

Select records to delete

Confirm deletion

​Next Steps

Record Types Reference

Reverse DNS

Troubleshooting

Create a Zone

Overview

Create a Record Set

View Record Sets

Update a Record Set

Delete Record Sets

Next Steps