Dns
SoftLayer_Dns_Domain_ResourceRecord_CnameType

Overview

SoftLayer_Dns_Domain_ResourceRecord_CnameType is a SoftLayer_Dns_Domain_ResourceRecord object whose type property is set to "cname" and defines a DNS CNAME record on a SoftLayer hosted domain. A CNAME record directs a host name to another host. For instance, if the CNAME record for "alias.example.org" points to the host "host.example.org" then the host property equals "alias" and the data property equals "host.example.org.".

DNS entries defined by CNAME should not be used as the data field for an MX record.

Local Properties

data

The value of a domain's resource record. This can be an IP address or a hostname. Fully qualified host and domain name data must end with the "." character.

Type:

string

domainId

An identifier belonging to the domain that a resource record is associated with.

Type:

integer

expire

The amount of time in seconds that a secondary name server (or servers) will hold a zone before it is no longer considered authoritative.

Type:

integer

host

The host defined by a resource record. A value of "@" denotes a wildcard.

Type:

string

id

A domain resource record's internal identifier.

Type:

integer

minimum

The amount of time in seconds that a domain's resource records are valid. This is also known as a minimum TTL, and can be overridden by an individual resource record's TTL.

Type:

integer

mxPriority

Useful in cases where a domain has more than one mail exchanger, the priority property is the priority of the MTA that delivers mail for a domain. A lower number denotes a higher priority, and mail will attempt to deliver through that MTA before moving to lower priority mail servers. Priority is defaulted to 10 upon resource record creation.

Type:

integer

refresh

The amount of time in seconds that a secondary name server should wait to check for a new copy of a DNS zone from the domain's primary name server. If a zone file has changed then the secondary DNS server will update it's copy of the zone to match the primary DNS server's zone.

Type:

integer

responsiblePerson

The email address of the person responsible for a domain, with the "@" replaced with a ".". For instance, if root@example.org is responsible for example.org, then example.org's SOA responsibility is "root.example.org.".

Type:

string

retry

The amount of time in seconds that a domain's primary name server (or servers) should wait if an attempt to refresh by a secondary name server failed before attempting to refresh a domain's zone with that secondary name server again.

Type:

integer

ttl

The Time To Live value of a resource record, measured in seconds. TTL is used by a name server to determine how long to cache a resource record. An SOA record's TTL value defines the domain's overall TTL.

Type:

integer

type

The string "cname" which defines a resource record as an CNAME record.

Type:

string

Relational & Count Properties

Relational Properties can be queried by object mask
domain

The domain that a resource record belongs to.