voxel.dns.records.update
Update a domain DNS record entry.
Parameters
domain_name(required)- Full domain name, without any protocol prefixes (e.g., "http://").
domain_record_id(required)- Domain record id of a Voxel DNS record entry, available from dns.records.list
domain_record_address(required)- Address for DNS record to resolve to.
domain_record_ttl(optional)- Maximum time to live, in seconds, for DNS record. Must be greater than 0 and less than or equal to 2147483647.
domain_record_priority(optional)- The priority of the domain record. Lower values signify higher priority. Must be a positive number less than or equal to 65535. Valid for MX and SRV records.
Example Response
<rsp stat="ok"/>
Notes
The domain_name parameter identifies a set of domain records belonging to a particular customer. The actual record to be updated should be specified by the "domain_record_id parameter obtained from dns.records.list, not the "domain_name" parameter.
This method currently updates all values for a domain record, or resets unspecified values to defaults. For example, if the existing record has a specified domain_record_ttl, calling this method without the domain_record_ttl parameter will reset it to the default. This resetting behavior is subject to change.
This method does not permit changing the domain_record_name.
See dns.records.create for example usage, as well as dns.records.delete, and dns.records.list.
Method Specific Error Codes
107: Unknown domain record- The domain_record_id passed in can't be matched to a valid Voxel DNS record for this user.
204: Domain action failed (reason)- An error occurred while performing an action on a domain. A reason may be specified in parenthesis.