editObject


SoftLayer_Dns_Secondary::editObject

Edit a secondary DNS record.

Description

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.

Parameters

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]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Dns_Secondary/{SoftLayer_Dns_SecondaryID}/editObject'