Domain Name Service (DNS)¶

The DNS client is the command-line interface (CLI) for the Domain Name Service (DNS) API and its extensions.

For help on a specific dns command, enter:

$ openstack dns help SUBCOMMAND

Zone operations¶

dns zone create¶

Create zone

openstack dns zone create
    [--email <email>]
    [--description <description>]
    [--type {private,public}]
    [--ttl <300-2147483647>]
    [--router_id <router_id>]
    [--router_region <router_region>]
    <name>

--email <email>¶: E-mail for the zone. Used in SOA records for the zone.

--description <description>¶: Description for this zone.

--type {private,public}¶: Domain name type, the value of which can be public or private .

--ttl <300-2147483647>¶: TTL (Time to Live) for the zone.

--router_id <router_id>¶: Router ID (VPC ID) for the private zone.

--router_region <router_region>¶: Router region for the private zone.

name¶: DNS Name for the zone.

This command is provided by the otcextensions plugin.

dns zone delete¶

Delete zone

openstack dns zone delete <zone> [<zone> ...]

zone¶: UUID or name of the zone.

This command is provided by the otcextensions plugin.

dns zone list¶

List DNS zones

openstack dns zone list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--type {private,public}]

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending¶: sort the column(s) in ascending order

--sort-descending¶: sort the column(s) in descending order

--type {private,public}¶: Zone type. Default lists only public zones.

This command is provided by the otcextensions plugin.

dns zone nameserver list¶

List DNS zone nameservers

openstack dns zone nameserver list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <zone>

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending¶: sort the column(s) in ascending order

--sort-descending¶: sort the column(s) in descending order

zone¶: UUID or name of the zone.

This command is provided by the otcextensions plugin.

dns zone router add¶

Associate router with a private zone

openstack dns zone router add
    [--router_id <router_id>]
    [--router_region <router_region>]
    <zone>

--router_id <router_id>¶: Router ID (VPC ID) for the private zone.

--router_region <router_region>¶: Router region for the private zone.

zone¶: UUID or name of the zone.

This command is provided by the otcextensions plugin.

dns zone router remove¶

Disassociate router with a private zone

openstack dns zone router remove
    [--router_id <router_id>]
    [--router_region <router_region>]
    <zone>

--router_id <router_id>¶: Router ID (VPC ID) for the private zone.

--router_region <router_region>¶: Router region for the private zone.

zone¶: UUID or name of the zone.

This command is provided by the otcextensions plugin.

dns zone set¶

Update a Zone

openstack dns zone set
    [--email <email>]
    [--description <description>]
    [--ttl <300-2147483647>]
    <zone>

--email <email>¶: E-mail for the zone. Used in SOA records for the zone.

--description <description>¶: Description for this zone.

--ttl <300-2147483647>¶: TTL (Time to Live) for the zone.

zone¶: UUID or name of the zone.

This command is provided by the otcextensions plugin.

dns zone show¶

Show the zone details

openstack dns zone show [--type <type>] <zone>

--type <type>¶: Mandatory for private Zone findings. Choices: public, private Default: public

zone¶: UUID or name of the zone.

This command is provided by the otcextensions plugin.

Recordset operations¶

dns recordset create¶

Create recordset

openstack dns recordset create
    [--zone-type ZONE_TYPE]
    --name <name>
    [--description <description>]
    [--type {A,AAAA,MX,TXT,CNAME,NS,SRV,PTR,CAA}]
    [--ttl <300-2147483647>]
    [--record <value>]
    <zone>

--zone-type <ZONE_TYPE>¶: DNS Zone type (private/public)

--name <name>¶: DNS Name for the zone.

--description <description>¶: Description for this zone.

--type {A,AAAA,MX,TXT,CNAME,NS,SRV,PTR,CAA}¶: Recordset type.

--ttl <300-2147483647>¶: TTL (Time to Live) for the zone.

--record <value>¶: Record set value, which varies depending on the record set type. For example, the value of an AAAA record set is the IPv6 address list mapped to the domain name.

zone¶: UUID or name of the zone.

This command is provided by the otcextensions plugin.

dns recordset delete¶

Delete Recordset

openstack dns recordset delete
    [--zone-type ZONE_TYPE]
    <zone>
    <rs>
    [<rs> ...]

--zone-type <ZONE_TYPE>¶: DNS Zone type (private/public)

zone¶: UUID or name of the zone.

rs¶: UUID or Name of the recordset.

This command is provided by the otcextensions plugin.

dns recordset list¶

List recordsets.

openstack dns recordset list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--zone-type ZONE_TYPE]
    <zone>

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending¶: sort the column(s) in ascending order

--sort-descending¶: sort the column(s) in descending order

--zone-type <ZONE_TYPE>¶: DNS Zone type (private/public)

zone¶: UUID or name of the zone. Recordsets of all zones will be returned if not given.

This command is provided by the otcextensions plugin.

dns recordset set¶

Update a Recordset

openstack dns recordset set
    [--zone-type ZONE_TYPE]
    [--description <description>]
    [--ttl <300-2147483647>]
    [--record <value>]
    <zone>
    <rs>

--zone-type <ZONE_TYPE>¶: DNS Zone type (private/public)

--description <description>¶: Description for this zone.

--ttl <300-2147483647>¶: TTL (Time to Live) for the zone.

--record <value>¶: Record set value, which varies depending on the record set type. For example, the value of an AAAA record set is the IPv6 address list mapped to the domain name.

zone¶: UUID or name of the zone.

rs¶: UUID or name of the recordset.

This command is provided by the otcextensions plugin.

dns recordset show¶

Show the recordset details

openstack dns recordset show [--zone-type ZONE_TYPE] <zone> <rs>

--zone-type <ZONE_TYPE>¶: DNS Zone type (private/public)

zone¶: UUID or name of the zone.

rs¶: UUID or name of the recordset.

This command is provided by the otcextensions plugin.

PTR operations¶

dns ptr record list¶

List PTR records

openstack dns ptr record list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]

--sort-column SORT_COLUMN¶: specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending¶: sort the column(s) in ascending order

--sort-descending¶: sort the column(s) in descending order

This command is provided by the otcextensions plugin.

dns ptr record set¶

Set PTR record

openstack dns ptr record set
    [--description <description>]
    [--ttl <300-2147483647>]
    floatingip_id
    ptrdname

--description <description>¶: Description for this record.

--ttl <300-2147483647>¶: TTL (Time to Live) for the zone.

floatingip_id¶: Floating IP ID in format region:floatingip_id.

ptrdname¶: PTRD Name

This command is provided by the otcextensions plugin.

dns ptr record show¶

Show the PTR record details

openstack dns ptr record show floatingip_id

floatingip_id¶: Floating IP ID in format region:floatingip_id.

This command is provided by the otcextensions plugin.

dns ptr record unset¶

Delete (restore) PTR record

openstack dns ptr record unset floatingip_id

floatingip_id¶: FloatingIP ID.

This command is provided by the otcextensions plugin.

last updated: 2023-06-12 09:35