SoftLayer_Dns_Domain_ResourceRecord::deleteObject

Delete a domain’s resource record.

Description

Delete a domain’s resource record. ‘‘‘This cannot be undone.’’’ Be wary of running this method. If you remove a resource record in error you will need to re-create it by creating a new SoftLayer_Dns_Domain_ResourceRecord object. The serial number of the domain associated with this resource record is updated upon deletion. You may not delete SOA, NS, or PTR resource records.

‘‘deleteObject’’ returns Boolean ‘’true’’ on successful deletion or ‘‘false’’ if it was unable to remove a resource record.

Parameters

None

Required Headers

• Authenticate
• SoftLayer_Dns_Domain_ResourceRecordInitParameters

Optional Headers

• None

Return Values

• boolean

Error Handling

• Throw the exception “SOA records may not be removed.” when attempting to remove an SOA resource record.
• Throw the exception “NS records may not be removed.” when attempting to remove an NS resource record.
• Throw the exception “PTR records may not be removed.” when attempting to remove a PTR resource record.

Associated Methods

• SoftLayer_Dns_ResourceRecord::deleteObjects

REST Example

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Dns_Domain_ResourceRecord/{SoftLayer_Dns_Domain_ResourceRecordID}/deleteObject'