dnscontrol/documentation/provider/linode.md

59 lines
1.3 KiB
Markdown
Raw Normal View History

2017-11-15 12:08:06 +08:00
## 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:
2017-11-15 12:08:06 +08:00
{% code title="creds.json" %}
```json
2017-11-15 12:08:06 +08:00
{
"linode": {
"TYPE": "LINODE",
2017-11-15 12:08:06 +08:00
"token": "your-linode-personal-access-token"
}
}
```
{% endcode %}
2017-11-15 12:08:06 +08:00
## Metadata
This provider does not recognize any special metadata fields unique to Linode.
## Usage
An example configuration:
2017-11-15 12:08:06 +08:00
{% code title="dnsconfig.js" %}
```javascript
var REG_NONE = NewRegistrar("none");
var DSP_LINODE = NewDnsProvider("linode");
2017-11-15 12:08:06 +08:00
D("example.com", REG_NONE, DnsProvider(DSP_LINODE),
A("test", "1.2.3.4")
2017-11-15 12:08:06 +08:00
);
```
{% endcode %}
2017-11-15 12:08:06 +08:00
## 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)):
2017-11-15 12:08:06 +08:00
- 0 (Default, currently equivalent to 1209600, or 14 days)
2017-11-15 12:08:06 +08:00
- 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.