voxel.dns.records.create

Create a domain DNS record entry.

Parameters

domain_name (required)
Full domain name, without any protocol prefixes (e.g., "http://").
domain_record_name (optional)
The name of the domain record
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.
domain_record_mboxfw_user (optional)
MBOXFW records allow mail to be redirected to a designated target address, based on records provided in the zone (domain).

Example Response

<rsp stat="ok">
                   <record id= 123>
                 </rsp>

Notes

To add domain records, you must have a domain managed through Voxel. Contact agile-support@internap.com if you need assistance.

The domain_name parameter identifies a set of domain records belonging to a particular customer. The actual record to be added to that domain should be specified by "domain_record_name," not by the "domain_name" parameter.

For example, if the domain name "example.com" is being managed by Voxel, a call with domain_name=example.com, domain_record_name=www, domain_record_type=A, and domain_record_address=192.168.1.1 will create an "A" record pointing "www.example.com" to the address 192.168.1.1.

Alternatively, domain_name=example.com, domain_record_type=CNAME, domain_record_name=*, and domain_record_address=my.other.host.com will create a CNAME record pointing "*.example.com" to "my.other.host.com."

See also voxel.dns.records.update, voxel.dns.records.list, and voxel.dns.records.delete.

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.