dnscontrol/docs/_functions/domain/DefaultTTL.md

26 lines
674 B
Markdown
Raw Normal View History

2017-01-12 04:02:45 +08:00
---
name: DefaultTTL
parameters:
- ttl
parameter_types:
ttl: Duration
2017-01-12 04:02:45 +08:00
---
DefaultTTL sets the TTL for all records in a domain that do not explicitly set one with [TTL](#TTL). If neither `DefaultTTL` or `TTL` exist for a record,
2017-01-12 04:02:45 +08:00
it will use the DNSControl global default of 300 seconds.
{% capture example %}
```js
D('example.com', REGISTRAR, DnsProvider('R53'),
2017-07-09 20:04:28 +08:00
DefaultTTL("4h"),
A('@','1.2.3.4'), // uses default
2017-07-09 20:04:28 +08:00
A('foo', '2.3.4.5', TTL(600)) // overrides default
2017-01-12 04:02:45 +08:00
);
```
2017-01-12 04:02:45 +08:00
2017-07-09 20:04:28 +08:00
The DefaultTTL duration is the same format as [TTL](#TTL), an integer number of seconds
or a string with a unit such as `'4d'`.
{% endcapture %}
{% include example.html content=example %}