A secondary DNS record may be converted to a primary DNS record. By converting a secondary DNS record, the SoftLayer name servers will be the authoritative nameserver for this domain and will be directly editable in the SoftLayer API and Portal.
Primary DNS record conversion performs the following steps: * The SOA record is updated with SoftLayer's primary name server. * All NS records are removed and replaced with SoftLayer's NS records. * The secondary DNS record is removed.
After the DNS records are converted, the following restrictions will apply to the new domain record: * You will need to manage the zone record using the [SoftLayer_Dns_Domain](/reference/datatypes/SoftLayer_Dns_Domain) service. * You may not edit the SOA or NS records. * You may only edit the following resource records: A, AAAA, CNAME, MX, TX, SRV.
This change can not be undone, and the record can not be converted back into a secondary DNS record once the conversion is complete.
Create multiple secondary DNS records. Each record passed to ''createObjects'' follows the logic in the SoftLayer_Dns_Secondary [SoftLayer_Dns_Secondary::createObject](/reference/datatypes/$1/#$2) method.
Delete a secondary DNS Record. This will also remove any associated domain records and resource records on the SoftLayer nameservers that were created as a result of the zone transfers. This action cannot be undone.
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.
Search for [SoftLayer_Dns_Secondary](/reference/datatypes/SoftLayer_Dns_Secondary) records by domain name. getByDomainName() performs an inclusive search for secondary domain records, returning multiple records based on partial name matches. Use this method to locate secondary domain records if you don't have access to their id numbers.
getObject retrieves the SoftLayer_Dns_Secondary object whose ID number corresponds to the ID number of the init paramater passed to the SoftLayer_Dns_Secondary service. You can only retrieve a secondary DNS record that is assigned to your SoftLayer customer account.
The SoftLayer_Dns_Secondary data type contains information on a single secondary DNS zone which is managed through SoftLayer's zone transfer service. Domains created via zone transfer may not be modified by the SoftLayer portal or API.
SoftLayer's secondary DNS service allows you to use SoftLayer's name servers as a secondary server to your domain's name servers. This is accomplished through the use of zone transfers. Each record created within the secondary DNS service defines which zone is transferred, what server it is transferred from, and the frequency that zone transfers occur at. Zone transfers are performed automatically based on the transfer frequency set on the secondary DNS record. Domains created via zone transfer may not be modified by the SoftLayer portal or API.
The secondary DNS service also provides the ability to manually initiate a zone transfer through the [SoftLayer_Dns_Secondary::transferNow](/reference/datatypes/$1/#$2) method. The daemon that performs zone transfers runs once a minute, therefore it could take a full minute for the zone transfer to be completed.
Secondary DNS transfers may periodically generate notification or error messages. Please use the [SoftLayer_Dns_Message](/reference/datatypes/SoftLayer_Dns_Message) service to retrieve these notifications.