1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Files
stackexchange-dnscontrol/docs/_functions/record/TTL.md
Julius Rickert 20dad35167 Replace Jekyll highlight tags with fenced code blocks (#1412)
* Replace Jekyll highlight tags with fenced code blocks

Replace Jekyll highlight tags with fenced code blocks.
Canonicalize javascript to js.
Correct highlighting languages.
Add highlighting to code blocks.
Remove leading $ from bash blocks.
Remove empty lines at start and end of code blocks.
Stripped trailing whitespace.

* Fix language of code highlighting
2022-02-17 12:22:31 -05:00

1.1 KiB

name, parameters
name parameters
TTL
ttl

TTL sets the TTL for a single record only. This will take precedence over the domain's DefaultTTL 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'?

{% include startExample.html %}

D('example.com', REGISTRAR, DnsProvider('R53'),
  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
);

{% include endExample.html %}