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/NAMESERVER_TTL.md
2023-03-12 09:08:37 -07:00

34 lines
991 B
Markdown

---
name: NAMESERVER_TTL
parameters:
- ttl
parameter_types:
ttl: Duration
target: string
modifiers...: RecordModifier[]
---
NAMESERVER_TTL sets the TTL on the domain apex NS RRs defined by [`NAMESERVER`](NAMESERVER.md).
The value can be an integer or a string. See [`TTL`](../record/TTL.md) for examples.
```javascript
D('example.com', REGISTRAR, DnsProvider('R53'),
NAMESERVER_TTL('2d'),
NAMESERVER('ns')
);
```
Use `NAMESERVER_TTL('3600'),` or `NAMESERVER_TTL('1h'),` for a 1h default TTL for all subsequent `NS` entries:
```javascript
D('example.com', REGISTRAR, DnsProvider('xyz'),
DefaultTTL("4h"),
NAMESERVER_TTL('3600'),
NAMESERVER('ns1.provider.com.'), //inherits NAMESERVER_TTL
NAMESERVER('ns2.provider.com.'), //inherits NAMESERVER_TTL
A('@','1.2.3.4'), // inherits DefaultTTL
A('foo', '2.3.4.5', TTL(600)) // overrides DefaultTTL for this record only
);
```
To apply a default TTL to all other record types, see [`DefaultTTL`](../domain/DefaultTTL.md)