github.com/StackExchange/dnscontrol/v4@v4.11.0/documentation/provider/cloudns.md (about)

     1  ## Configuration
     2  
     3  To use this provider, add an entry to `creds.json` with `TYPE` set to `CLOUDNS`
     4  along with your [Api user ID and password](https://www.cloudns.net/wiki/article/42/).
     5  
     6  Example:
     7  
     8  {% code title="creds.json" %}
     9  ```json
    10  {
    11    "cloudns": {
    12      "TYPE": "CLOUDNS",
    13      "auth-id": "12345",
    14      "sub-auth-id": "12345",
    15      "auth-password": "your-password"
    16    }
    17  }
    18  ```
    19  {% endcode %}
    20  
    21  Current version of provider doesn't support `sub-auth-user`.
    22  
    23  ## Records
    24  
    25  ClouDNS does support DS Record on subdomains (not the apex domain itself).
    26  
    27  ClouDNS requires NS records exist for any DS records. No other records for
    28  the same label may exist (A, MX, TXT, etc.). If DNSControl is adding NS and
    29  DS records in the same update, the NS records will be inserted first.
    30  
    31  ## Metadata
    32  This provider does not recognize any special metadata fields unique to ClouDNS.
    33  
    34  ## Web Redirects
    35  ClouDNS supports ClouDNS-specific "WR record (web redirects)" for your domains.
    36  Simply use the `CLOUDNS_WR` functions to make redirects like any other record:
    37  
    38  {% code title="dnsconfig.js" %}
    39  ```javascript
    40  var REG_NONE = NewRegistrar("none");
    41  var DSP_CLOUDNS = NewDnsProvider("cloudns");
    42  
    43  D("example.com", REG_NONE, DnsProvider(DSP_CLOUDNS),
    44    CLOUDNS_WR("@", "http://example.com/"),
    45    CLOUDNS_WR("www", "http://example.com/"),
    46  END)
    47  ```
    48  {% endcode %}
    49  
    50  ## Usage
    51  An example configuration:
    52  
    53  {% code title="dnsconfig.js" %}
    54  ```javascript
    55  var REG_NONE = NewRegistrar("none");
    56  var DSP_CLOUDNS = NewDnsProvider("cloudns");
    57  
    58  D("example.com", REG_NONE, DnsProvider(DSP_CLOUDNS),
    59      A("test", "1.2.3.4"),
    60  END);
    61  ```
    62  {% endcode %}
    63  
    64  ## Activation
    65  [Create Auth ID](https://www.cloudns.net/api-settings/).  Only paid account can use API
    66  
    67  ## Caveats
    68  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/):
    69  - 60  (1 minute)
    70  - 300 (5 minutes)
    71  - 900 (15 minutes)
    72  - 1800 (30 minutes)
    73  - 3600 (1 hour)
    74  - 21600 (6 hours)
    75  - 43200 (12 hours)
    76  - 86400 (1 day)
    77  - 172800 (2 days)
    78  - 259200 (3 days)
    79  - 604800 (1 week)
    80  - 1209600 (2 weeks)
    81  - 2419200 (4 weeks)
    82  
    83  The provider will automatically round up your TTL to one of these values. For example, 350 seconds would become 900
    84  seconds, but 300 seconds would stay 300 seconds.