Wiki

Modify record

Description

Modify record in domain zone.

Note 1: This function is available only for master zones. Works with reverse zones too.
Note 2: With this function you can't modify the record type.


Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user  Integer Required Authentication parameter
auth-password String  Required Authentication parameter
domain-name String Required Domain name or reverse zone name you want to assign new record to
record-id Integer  Required Record ID. You can see this ID with the method List records
host  String Required host / subdomain
record String  Required Record you want to add. Example 10.10.10.10 or cname.cloudns.net
ttl Integer  Required Available TTL's:
60 = 1 minute
300 = 5 minutes
900 = 15 minutes
1800 = 30 minutes
3600 = 1 hour
21600 = 6 hours
43200 = 12 hours
86400 = 1 day
172800 = 2 days
259200 = 3 days
604800 = 1 week
1209600 = 2 weeks
2592000 = 1 month
priority  Integer Optional  Priority for MX or SRV record
weight Integer  Optional  Weight for SRV record
port Integer  Optional  Port for SRV record
frame Integer  Optional  0 or 1 for Web redirects to disable or enable frame
frame-title String  Optional Tile if frame is enabled in Web redirects
frame-keywords String Optional Keywords if frame is enabled in Web redirects
frame-description String Optional Description if frame is enabled in Web redirects
save-path Integer Optional 0 or 1 for Web redirects
redirect-type Integer Optional 301 or 302 for Web redirects if frame is disabled
mail Integer Optional E-mail address for RP records
txt Integer Optional Domain name for TXT record used in RP records
algorithm Integer Optional Algorithm used to create the SSHFP fingerprint. Required for SSHFP records only.
fptype Integer Optional Type of the SSHFP algorithm. Required for SSHFP records only.

Return: Array with status and status description.


Example

URL JSON: https://api.cloudns.net/dns/mod-record.json
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=0000000&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-id=0000000&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-id=0000000&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-id=0000000&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-id=0000000&host=@&record=domain.com&ttl=3600


URL XML: https://api.cloudns.net/dns/mod-record.xml
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-id=0000000&host=www&record=10.10.10.10&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=0000000&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-id=0000000&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-id=0000000&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-id=0000000&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-id=0000000&host=@&record=domain.com&ttl=3600

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more