mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2024-05-11 05:55:12 +00:00
59 lines
1.3 KiB
Markdown
59 lines
1.3 KiB
Markdown
## Configuration
|
|
|
|
To use this provider, add an entry to `creds.json` with `TYPE` set to `LINODE`
|
|
along with your [Linode Personal Access Token](https://cloud.linode.com/profile/tokens).
|
|
|
|
Example:
|
|
|
|
{% code title="creds.json" %}
|
|
```json
|
|
{
|
|
"linode": {
|
|
"TYPE": "LINODE",
|
|
"token": "your-linode-personal-access-token"
|
|
}
|
|
}
|
|
```
|
|
{% endcode %}
|
|
|
|
## Metadata
|
|
This provider does not recognize any special metadata fields unique to Linode.
|
|
|
|
## Usage
|
|
An example configuration:
|
|
|
|
{% code title="dnsconfig.js" %}
|
|
```javascript
|
|
var REG_NONE = NewRegistrar("none");
|
|
var DSP_LINODE = NewDnsProvider("linode");
|
|
|
|
D("example.tld", REG_NONE, DnsProvider(DSP_LINODE),
|
|
A("test", "1.2.3.4")
|
|
);
|
|
```
|
|
{% endcode %}
|
|
|
|
## Activation
|
|
[Create Personal Access Token](https://cloud.linode.com/profile/tokens)
|
|
|
|
## Caveats
|
|
Linode does not allow all TTLs, but only a specific subset of TTLs. The following TTLs are supported
|
|
([source](https://www.linode.com/docs/api/domains/#domains-list__responses)):
|
|
|
|
- 0 (Default, currently equivalent to 1209600, or 14 days)
|
|
- 300
|
|
- 3600
|
|
- 7200
|
|
- 14400
|
|
- 28800
|
|
- 57600
|
|
- 86400
|
|
- 172800
|
|
- 345600
|
|
- 604800
|
|
- 1209600
|
|
- 2419200
|
|
|
|
The provider will automatically round up your TTL to one of these values. For example, 600 seconds would become 3600
|
|
seconds, but 300 seconds would stay 300 seconds.
|