mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2025-01-13 02:50:27 +08:00
9949cba00d
- Changed the URL of the ClouDNS document from "asia.cloudns.net" to "www.cloudns.net". - A little addition about TTL.
67 lines
1.7 KiB
Markdown
67 lines
1.7 KiB
Markdown
---
|
|
name: ClouDNS
|
|
title: ClouDNS Provider
|
|
layout: default
|
|
jsId: CLOUDNS
|
|
---
|
|
# ClouDNS Provider
|
|
|
|
## Configuration
|
|
In your credentials file, you must provide your [Api user ID and password](https://www.cloudns.net/wiki/article/42/).
|
|
|
|
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](https://www.cloudns.net/api-settings/). Only paid account can use API
|
|
|
|
## Caveats
|
|
ClouDNS does not allow all TTLs, only a specific subset of TTLs. By default, the following [TTLs are supported](https://www.cloudns.net/wiki/article/188/):
|
|
- 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.
|