dnscontrol/docs/_providers/cloudns.md
taybinakh d7f40ed680
Implement DS record support for ClouDNS (#1018)
* Add PTR support for ClouDNS

* Implement PTR Support for CLouDNS

* implemnent DS Record for ClouDNS

* implement DS record for clouDNS

* pull request review

* note that SshFpAlgorithm and DsAlgorithm both use json field algorithm

* primitive rate limit and fix order of NS/DS-entries

* codefixes

Co-authored-by: IT-Sumpfling <it-sumpfling@maxit-con.de>
Co-authored-by: bentaybi jamal <jamal@pfalzcloud.de>
Co-authored-by: Tom Limoncelli <tlimoncelli@stackoverflow.com>
2021-01-22 12:54:39 -05:00

1.7 KiB

name title layout jsId
ClouDNS ClouDNS Provider default CLOUDNS

ClouDNS Provider

Configuration

In your credentials file, you must provide your Api user ID and password.

Current version of provider doesn't support sub-auth-user.

{% highlight json %} { "cloudns": { "auth-id": "12345", "sub-auth-id": "12345", "auth-password": "your-password" } } {% endhighlight %}

Records

ClouDNS does support DS Record on subdomains (not the apex domain itself).

ClouDNS requires NS records exist for any DS records. No other records for the same label may exist (A, MX, TXT, etc.). If DNSControl is adding NS and DS records in the same update, the NS records will be inserted first.

Metadata

This provider does not recognize any special metadata fields unique to ClouDNS.

Usage

Example Javascript:

{% highlight js %} var REG_NONE = NewRegistrar('none', 'NONE') var CLOUDNS = NewDnsProvider("cloudns", "CLOUDNS");

D("example.tld", REG_NONE, DnsProvider(CLOUDNS), A("test","1.2.3.4") ); {%endhighlight%}

Activation

Create Auth ID. Only paid account can use API

Caveats

ClouDNS does not allow all TTLs, but only a specific subset of TTLs. The following TTLs are supported:

  • 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)
  • 2419200 (4 weeks)

The provider will automatically round up your TTL to one of these values. For example, 350 seconds would become 900 seconds, but 300 seconds would stay 300 seconds.