Dns
SoftLayer_Dns_Domain_ResourceRecord_MxType

Overview

SoftLayer_Dns_Domain_ResourceRecord_MxType is a SoftLayer_Dns_Domain_ResourceRecord object whose type property is set to "mx" and used to describe MX resource records. MX records control which hosts are responsible as mail exchangers for a domain. For instance, in the domain example.org, an MX record whose host is "@" and data is "mail" says that the host "mail.example.org" is responsible for handling mail for example.org. That means mail sent to users @example.org are delivered to mail.example.org.

Domains can have more than one MX record if it uses more than one server to send mail through. Multiple MX records are denoted by their priority, defined by the mxPriority property.

MX records must be defined for hosts with accompanying A or AAAA resource records. They may not point mail towards a host defined by a CNAME 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 "mx" which defines a resource record as an MX record.

Type:

string

Relational & Count Properties

Relational Properties can be queried by object mask
domain

The domain that a resource record belongs to.