Language: English

Dns
SoftLayer_Dns_Domain_ResourceRecord_PtrType

Overview

SoftLayer_Dns_Domain_ResourceRecord_PtrType is a SoftLayer_Dns_Domain_ResourceRecord object whose type property is set to "ptr" and defines a reverse DNS PTR record on the SoftLayer name servers.

The format for a reverse DNS PTR record varies based on whether it is for an IPv4 or IPv6 address.

For an IPv4 address the host property for every PTR record is the last octet of the IP address that the PTR record belongs to, while the data property is the canonical name of the host that the reverse lookup resolves to. Every PTR record belongs to a domain on the SoftLayer name servers named by the first three octets of an IP address in reverse order followed by ".in-addr.arpa".

For instance, if the reverse DNS record for 10.0.0.1 is "host.example.org" then it's corresponding SoftLayer_Dns_Domain_ResourceRecord_PtrType host is "1", while it's data property equals "host.example.org". The full name of the reverse record for host.example.org including the domain name is "1.0.0.10.in-addr.arpa".

For an IPv6 address the host property for every PTR record is the last four octets of the IP address that the PTR record belongs to. The last four octets need to be in reversed order and each digit separated by a period. The data property is the canonical name of the host that the reverse lookup resolves to. Every PTR record belongs to a domain on the SoftLayer name servers named by the first four octets of an IP address in reverse order, split up by digit with a period, and followed by ".ip6.arpa".

For instance, if the reverse DNS record for fe80:0000:0000:0000:0000:0000:0a00:0001 is "host.example.org" then it's corresponding SoftLayer_Dns_Domain_ResourceRecord_PtrType host is "1.0.0.0.0.0.a.0.0.0.0.0.0.0.0.0", while it's data property equals "host.example.org". The full name of the reverse record for host.example.org including the domain name is "1.0.0.0.0.0.a.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.e.f.ip6.arpa".

PTR record host names may not be changed by SoftLayer_Dns_Domain_ResourceRecord::editObject or SoftLayer_Dns_Domain_ResourceRecord::editObjects.

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

isGatewayAddress

Whether the address associated with a PTR record is the gateway address of a subnet.

Type:

boolean

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 "ptr" which defines a resource record as a PTR record.

Type:

string

Relational & Count Properties

Relational Properties can be queried by object mask
domain

The domain that a resource record belongs to.