SoftLayer Dns Domain ResourceRecord NsType
From SoftLayer Development Network Wiki
Contents |
Overview
SoftLayer_Dns_Domain_ResourceRecord_NsType is a SoftLayer_Dns_Domain_ResourceRecord object whose type property is set to "ns" and defines a DNS NS record on a SoftLayer hosted domain. An NS record defines the authoritative name server for a domain. All SoftLayer hosted domains contain NS records for "ns1.softlayer.com" and "ns2.softlayer.com" . For instance, if example.org is hosted on ns1.softlayer.com, then example.org contains an NS record whose host property equals "@" and whose data property equals "ns1.example.org".
NS resource records pointing to ns1.softlayer.com or ns2.softlayer.com many not be removed from a SoftLayer hosted domain.
User Access
Users wishing to access the SoftLayer_Dns_Domain_ResourceRecord_NsType type must have the Manage DNS permission assigned to their account.
| Warning! Even though our API is object based, XML-RPC can only return data as array values. The SOAP implementation treats data as object properties. |
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.
data is required for object creation.
- Type: string
- Length: 255 characters
domainId
An identifier belonging to the domain that a resource record is associated with.
domainId is required for object creation.
- Type: integer
- Length: 8 digits
host
The host defined by a resource record. A value of "@" denotes a wildcard.
host is required for object creation.
- Type: string
- Length: 50 characters
- Default Value: @
id
A domain resource record's internal identifier.
- 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.
ttl is required for object creation.
- Type: integer
- Length: 8 digits
- Default Value: 86400
type
The string "ns" which defines a resource record as an NS record.
type is required for object creation.
- Type: string
- Length: 5 characters
Relational Properties
domain
The domain that a resource record belongs to.
domain can be queried by object mask.
domain must be a unique value.
- Type: SoftLayer_Dns_Domain
