deleteObjects

Classes SoftLayer_Dns_Domain_ResourceRecord
Tags method sldn dns

SoftLayer_Dns_Domain_ResourceRecord::deleteObjects

Delete multiple resource records from a domain.

Description

Remove multiple resource records from a domain. This follows the same logic as ‘‘deleteObject’’ and ‘‘‘cannot be undone’’’. The serial number of the domain associated with this resource record is updated upon deletion. You may not delete SOA records, PTR records, or NS resource records that point to ns1.softlayer.com or ns2.softlayer.com.

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

Parameters

Name Type Description
templateObjects SoftLayer_Dns_Domain_ResourceRecord[] An array of skeleton SoftLayer_Dns_Domain_ResourceRecord objects that you wish to delete. Each object in the array must have at least their id properties defined.

Required Headers

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 for ns1.softlayer.com or ns2.softlayer.com may not be removed.” when attempting to remove an NS resource record that points to ns1.softlayer.com or ns2.softlayer.com.
  • Throw the exception “PTR records may not be removed.” when attempting to remove a PTR resource record.

Associated Methods

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