SoftLayer_Dns_Domain::createObject

Create a new domain.

Description

Create a new domain on the SoftLayer name servers. The SoftLayer_Dns_Domain object passed to this function must have at least one A or AAAA 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.

‘‘createObject’’ returns a Boolean ‘’true’’ on successful object creation or ‘‘false’’ if your domain was unable to be created..

Parameters

Required Headers

• Authenticate

Optional Headers

• SoftLayer_Dns_DomainObjectMask

Return Values

• SoftLayer_Dns_Domain

Error Handling

• Throw the exception “At least one valid ‘A’ or ‘AAAA’ resource record is required to create a domain.” if the domain in the templateObject parameter doesn’t have at least one A or AAAA resource record.

Associated Methods

• SoftLayer_Dns_Domain::createObjects

REST Example

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_Dns_Domain]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Dns_Domain/createObject'