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

     1  ## Configuration
     2  
     3  To use this provider, add an entry to `creds.json` with `TYPE` set to `LINODE`
     4  along with your [Linode Personal Access Token](https://cloud.linode.com/profile/tokens).
     5  
     6  Example:
     7  
     8  {% code title="creds.json" %}
     9  ```json
    10  {
    11    "linode": {
    12      "TYPE": "LINODE",
    13      "token": "your-linode-personal-access-token"
    14    }
    15  }
    16  ```
    17  {% endcode %}
    18  
    19  ## Metadata
    20  This provider does not recognize any special metadata fields unique to Linode.
    21  
    22  ## Usage
    23  An example configuration:
    24  
    25  {% code title="dnsconfig.js" %}
    26  ```javascript
    27  var REG_NONE = NewRegistrar("none");
    28  var DSP_LINODE = NewDnsProvider("linode");
    29  
    30  D("example.com", REG_NONE, DnsProvider(DSP_LINODE),
    31      A("test", "1.2.3.4"),
    32  END);
    33  ```
    34  {% endcode %}
    35  
    36  ## Activation
    37  [Create Personal Access Token](https://cloud.linode.com/profile/tokens)
    38  
    39  ## Caveats
    40  Linode does not allow all TTLs, but only a specific subset of TTLs. The following TTLs are supported
    41  ([source](https://www.linode.com/docs/api/domains/#domains-list__responses)):
    42  
    43  - 0 (Default, currently equivalent to 1209600, or 14 days)
    44  - 300
    45  - 3600
    46  - 7200
    47  - 14400
    48  - 28800
    49  - 57600
    50  - 86400
    51  - 172800
    52  - 345600
    53  - 604800
    54  - 1209600
    55  - 2419200
    56  
    57  The provider will automatically round up your TTL to one of these values. For example, 600 seconds would become 3600
    58  seconds, but 300 seconds would stay 300 seconds.