Skip to content

dns cnameRec

The following operations can be performed on "dns cnameRec":

add | rm | show

add dns cnameRec

Creates a canonical name (CNAME) record, or alias, for the specified domain name.

Synopsys

add dns cnameRec <aliasName> <canonicalName> [-TTL <secs>]

Arguments

aliasName

Alias for the canonical domain name.

canonicalName

Canonical domain name.

TTL

Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the NetScaler appliance uses either the DNS zone's minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600.

Default value: 3600

Maximum value: 2147483647

Example

add dns cnameRec www.mynw.org www.mynw.com -ttl 20

rm dns cnameRec

Removes a canonical name (CNAME) record. For EDNS Client Subnet (ECS) records, a subnet needs to be specified to remove a CNAME record which is cached for that particular subnet

Synopsys

rm dns cnameRec <aliasName> [-ecsSubnet <ip_addr[/prefix]|ipv6_addr[/prefix]>]

Arguments

aliasName

Alias for which to remove the CNAME record.

ecsSubnet

Subnet for which the cached CNAME record need to be removed.

Example

rm dns cnamerec www.mynw.org

show dns cnameRec

Displays the canonical name (CNAME) records configured for the specified alias. If no alias is specified, all configured CNAME records are displayed

Synopsys

show dns cnameRec [<aliasName> | -type <type>]

Arguments

aliasName

Alias for which to display CNAME records.

type

Type of records to display. Available settings function as follows:

  • ADNS - Display all authoritative address records.

  • PROXY - Display all proxy address records.

  • ALL - Display all address records.

Possible values: ALL, ADNS, PROXY

Default value: ADNS

Outputs

canonicalName

Canonical domain name.

TTL

Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the NetScaler appliance uses either the DNS zone's minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600.

vServerName

GSLB Vitual server name to which this domain is bound

authType

Record type.

ecsSubnet

Subnet for which this particular record is cached. Subnet caching will occur for responses with EDNS Client Subnet (ECS) option. Applies to resource records obtained through proxy configurations only.

devno

count

stateflag

Example

show dns cnameRec www.mynw.org