SoftLayer Dns Domain::createObject
From SoftLayer Development Network Wiki
createObject is a member of the SoftLayer_Dns_Domain service.
Contents |
Overview
Create a new domain on the SoftLayer name servers. The SoftLayer_Dns_Domain object passed to this function must have at least one A resource record.
createObject creates a default SOA record with the data:
- host: "@"
- data: "ns1.softlayer.com."
- responsible person: "root.[your domain name]."
- expire: 604800 seconds
- refresh: 3600 seconds
- retry: 300 seconds
- minimum: 3600 seconds
If your new domain uses the .de top-level domain then SOA refresh is set to 10000 seconds, retry is set to 1800 seconds, and minimum to 10000 seconds.
If your domain doesn't contain NS resource records for ns1.softlayer.com or ns2.softlayer.com then createObject will create them for you.
The first A resource record defined in the templateObject parameter also defines the following default records:
- An A record for DNS wildcards ("@")
- An A record for "www"
- An A record for "mail"
- An A record for "webmail"
- An A record for "ftp"
Finally, createObject creates a default MX resource record for "mail.[your domain name].".
createObject returns a Boolean true on successful object creation or false if your domain was unable to be created..
User Access
Users wishing to execute createObject service must have the Manage DNS permission assigned to their account.
Return Type
createObject returns the SoftLayer_Dns_Domain data type.
Headers
Required Headers
createObject requires the following headers:
Parameters
createObject takes the following parameters:
templateObject
The SoftLayer_Dns_Domain object that you wish to create.
- Type: SoftLayer_Dns_Domain
Error Handling
createObject throws the following exceptions:
- SoftLayer_Exception
- Throw the exception "At least one valid 'A' resource record is required to create a domain." if the domain in the templateObject parameter doesn't have at least one A resource record.
