DynamicDNS Code Examples

The DynamicDNS service is used to automatically update dynamic IP addresses.

In the following you find the supported command set in order to use the DynamicDNS feature, and the syntax of the RRPproxy DynamicDNS URL.

AddDynamicDNS

Activation of the DynamicDNS feature for a domain name.
Please note: The corresponding appendix must be activated and the domain name must be under the management of the respective RRPproxy account to execute this command.

[COMMAND]
command = AddDynamicDNS
hostname = example.com
password = [secret password]
EOF

DeleteDynamicDNS

Deactivation of the DynamicDNS feature for a domain name.

[COMMAND]
command = DeleteDynamicDNS
hostname = example.com
EOF

StatusDynamicDNS

Display of status information for a DynamicDNS entry.

[COMMAND]
command = StatusDynamicDNS
hostname = example.com
wide = 1 (optional)
EOF

Upon successful execution:
[RESPONSE]
code = 200
description = Command completed successfully
property[status][0] = ACTIVE | DISABLED
property[updated date][0] = [date]
property[updated by][0] = registrar | webapi
(webapi means that the last update to the record has been made via update URL)
property[created date][0] = [date]
property[password][0] = [secret password] (will only be displayed if "wide=1" is given)

QueryDynamicDNSList

Display a list of all configured DynamicDNS records.

[COMMAND]
command=QueryDynamicDNSList
wide=1 (optional)
EOF

ModifyDynamicDNS

Used to update settings regarding a DynamicDNS entry. Either a new status (active/disabled), a new password or both together can be set.

[COMMAND
command = ModifyDynamicDNS
hostname = example.com
password = [another secret password] (optional)
status = ACTIVE | DISABLED (optional)
EOF

UpdateDynamicDNS

Update of the IP/MX record of a DynamicDNS record.
To prevent abuse the system only allows to perform the UpdateDynamicDNS command every 2 minutes.

[COMMAND]
command = UpdateDynamicDNS
hostname = example.com
password = [secret password]
ip = 213.124.0.1 (optional)
mx = mx.example.com (optional)
EOF

DynamicDNS URL

As an alternative to the UpdateDynamicDNS command, you can use the following two URLs in order to update the IP/MX records accordingly. The value “auto” within the parameter “ip” automatically submits the IP address of the http request client.

http://dynamicdns.key-systems.net/update.php?hostname=hostname&password=password&ip=auto
http://dynamicdns.key-systems.net/update.php?hostname=hostname&password=password&ip=213.4.7.1&
mx = mx.example.com