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 voxel.dns.records.list
domain_record_type (required)
Type of DNS record to manage for domain. One of: A, AAAA, CNAME, CURL, MBOXFW, MX, NS, SRV, TXT, URL, PTR.
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 voxel.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 voxel.dns.records.create for example usage, as well as voxel.dns.records.delete, and voxel.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.