mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2024-05-11 05:55:12 +00:00
DOCS: Documentation directory structure (#2905)
This commit is contained in:
committed by
GitHub
parent
17d644cfc6
commit
c31064781f
37
documentation/language-reference/record-modifiers/TTL.md
Normal file
37
documentation/language-reference/record-modifiers/TTL.md
Normal file
@@ -0,0 +1,37 @@
|
||||
---
|
||||
name: TTL
|
||||
parameters:
|
||||
- ttl
|
||||
parameter_types:
|
||||
ttl: Duration
|
||||
---
|
||||
|
||||
TTL sets the TTL for a single record only. This will take precedence
|
||||
over the domain's [DefaultTTL](../domain-modifiers/DefaultTTL.md) if supplied.
|
||||
|
||||
The value can be:
|
||||
|
||||
* An integer (number of seconds). Example: `600`
|
||||
* A string: Integer with single-letter unit: Example: `5m`
|
||||
* The unit denotes:
|
||||
* s (seconds)
|
||||
* m (minutes)
|
||||
* h (hours)
|
||||
* d (days)
|
||||
* w (weeks)
|
||||
* n (nonths) (30 days in a nonth)
|
||||
* y (years) (If you set a TTL to a year, we assume you also do crossword puzzles in pen. Show off!)
|
||||
* If no unit is specified, the default is seconds.
|
||||
* We highly recommend using units instead of the number of seconds. Would your coworkers understand your intention better if you wrote `14400` or `'4h'`?
|
||||
|
||||
{% code title="dnsconfig.js" %}
|
||||
```javascript
|
||||
D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
|
||||
DefaultTTL(2000),
|
||||
A("@","1.2.3.4"), // uses default
|
||||
A("foo", "2.3.4.5", TTL(500)), // overrides default
|
||||
A("demo1", "3.4.5.11", TTL("5d")), // 5 days
|
||||
A("demo2", "3.4.5.12", TTL("5w")), // 5 weeks
|
||||
);
|
||||
```
|
||||
{% endcode %}
|
Reference in New Issue
Block a user