1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Files
stackexchange-dnscontrol/documentation/functions/domain/DefaultTTL.md

27 lines
972 B
Markdown
Raw Normal View History

2017-01-11 13:02:45 -07:00
---
name: DefaultTTL
parameters:
- ttl
parameter_types:
ttl: Duration
2017-01-11 13:02:45 -07:00
---
2023-03-12 17:08:37 +01:00
DefaultTTL sets the TTL for all subsequent records following it in a domain that do not explicitly set one with [`TTL`](../record/TTL.md). If neither `DefaultTTL` or `TTL` exist for a record,
the record will inherit the DNSControl global internal default of 300 seconds. See also [`DEFAULTS`](../global/DEFAULTS.md) to override the internal defaults.
NS records are currently a special case, and do not inherit from `DefaultTTL`. See [`NAMESERVER_TTL`](../domain/NAMESERVER_TTL.md) to set a default TTL for all NS records.
2017-01-11 13:02:45 -07:00
{% code title="dnsconfig.js" %}
```javascript
D('example.com', REGISTRAR, DnsProvider('R53'),
2017-07-09 08:04:28 -04:00
DefaultTTL("4h"),
A('@','1.2.3.4'), // uses default
2017-07-09 08:04:28 -04:00
A('foo', '2.3.4.5', TTL(600)) // overrides default
2017-01-11 13:02:45 -07:00
);
```
{% endcode %}
2017-01-11 13:02:45 -07:00
2023-03-12 17:08:37 +01:00
The DefaultTTL duration is the same format as [`TTL`](../record/TTL.md), an integer number of seconds
or a string with a unit such as `'4d'`.