DNS Services

class StandardService(service_ipv4, service_ipv6, username, password, hostname, **extra_params)

Updates a DNS service that uses the defacto standard protocol that has been defined by Dyn. All the standard return codes are handled. Client configuration errors will cause the service to be disabled.

Parameters
  • service_ipv4 – domain name of the IPv4 update service

  • service_ipv6 – domain name of the IPv6 update service

  • username – service username (some services use the your (sub)domain name as the username)

  • password – service password (sometimes this is a unique password for a specific (sub)domain rather than your actual password)

  • hostname – fully qualified domain name to update

  • extra_params – other keyword arguments that will be appended to the request URL

class FreeDNS(ipv4_key, ipv6_key=None)

Updates a domain on FreeDNS using the version 2 interface. This API uses a single key for each entry (separate ones for IPv4 and IPv6) instead of separately passing the domain, username and password. The keys are the last part of the given update URL, not including the trailing slash.

For example, the update key for the URL http://sync.afraid.org/u/VWZIcQnBScVv8yv8DhJxDbnt/ is VWZIcQnBScVv8yv8DhJxDbnt

Parameters
  • ipv4_key – update key for IPv4

  • ipv6_key – update key for IPv6

class NSUpdate(hostname, secret_key)

Updates a domain on nsupdate.info. nsupdate.info uses the Dyn protocol.

Parameters
  • hostname – fqdn to update

  • secret_key – update key

class OVHDynDNS(username, password, hostname, system='dyndns')

Updates a domain using OVH’s DynDNS service. This service uses the standard Dyn protocol, with an extra system parameter. This service only supports IPv4.

Parameters
  • username – account username

  • password – account password

  • hostname – the hostname to update

  • system – the type of update (default: dyndns)

class GoogleDomains(username, password, hostname)

Updates a domain registered through Google Domains. This service uses the standard Dyn protocol. This service only supports IPv4.

Parameters
  • username – account username

  • password – account password

  • hostname – the hostname to update

class StaticURL(ipv4_url, ipv6_url=None)

Updates addresses by sending an HTTP GET request to statically configured URLs. When using this type of service, the remote server will automatically detect your IP and therefore the address provided by the configured address provider will not be used. In most cases, the result will be the same as if the Web provider had been used.

Parameters
  • ipv4_url – URL used to update the IPv4 address

  • ipv6_url – URL used to update the IPv6 address