Add record

Description

Add a new record to the domain zone.

Note: This function is available only for master zones. Works with reverse and ENUM zones too.

 Parameters

Response: Array with status and status description.

Errors

When the authentication of the API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

In case the credentials of the API sub-user are invalid, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect sub-auth-id, sub-auth-user or auth-password."}

When an invalid or non-existent domain-name is entered, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain-name"}

If an invalid record type is entered for the record-type parameter, the following status will be returned:

{"status":"Failed","statusDescription":"This record type is not supported."}

When the TTL parameter is not from the suggested values or an Integer, the API request will fail, and the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid TTL. Choose from the list of the values we support."}

If an invalid value is entered for the record parameter, the API request will fail and a statusDescription message will be displayed, based on the record type:

- When an invalid value is entered for records that require a domain name as a record parameter:

{"status":"Failed","statusDescription":"This is not a domain name."}

- When an invalid value is entered for records that require a URL as a record parameter:

{"status":"Failed","statusDescription":"The domain must be pointed to an URL as shown in the example."}

- When an invalid value is entered for records that require an IP address as a record parameter:

{"status":"Failed","statusDescription":"This is not a valid IP address."}

Note: These are example errors in JSON format.

Example

URL JSON: https://api.cloudns.net/dns/add-record.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600

URL XML: https://api.cloudns.net/dns/add-record.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600