dnscontrol/docs/_functions/domain/DefaultTTL.md
2017-07-09 08:04:28 -04:00

23 lines
648 B
Markdown

---
name: DefaultTTL
parameters:
- ttl
---
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,
it will use the DNSControl global default of 300 seconds.
{% include startExample.html %}
{% highlight js %}
D('example.com', REGISTRAR, DnsProvider('R53'),
DefaultTTL("4h"),
A('@','1.2.3.4'), // uses default
A('foo', '2.3.4.5', TTL(600)) // overrides default
);
{%endhighlight%}
The DefaultTTL duration is the same format as [TTL](#TTL), an integer number of seconds
or a string with a unit such as `'4d'`.
{% include endExample.html %}