Edit a secondary DNS record.


Edit the properties of a secondary DNS record by passing in a modified instance of a SoftLayer_Dns_Secondary object. You may only edit the ‘‘masterIpAddress’’ and ‘’transferFrequency’’ properties of your secondary DNS record. ‘‘ZoneName’’ may not be altered after a secondary DNS record has been created. Please remove and re-create the record if you need to make changes to your zone name.


Name Type Description
templateObject SoftLayer_Dns_Secondary A skeleton SoftLayer_Dns_Secondary object with only the properties defined that you wish to change. Unchanged properties are left alone.

Required Headers

Optional Headers

  • None

Return Values

  • boolean

Error Handling

  • Throw the exception “The zone name may not be edited after the secondary DNS record is created.” if you are trying to edit the zone name.
  • Throw the exception “The master IP address is not a valid IP address.” if the supplied master IP address is not in a valid IP format.
  • Throw the exception “The transfer frequency must be numeric.” if the transfer frequency is blank or not a valid number.
curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_Dns_Secondary]}' \