community.dns.hetzner_dns_records инвентаризация – Создание инвентаризации из записей DNS Hetzner

filters

список / элементы=словарь

добавлен в community.dns 3.0.0

Список фильтров включения/исключения, позволяющий выбирать/отключать хосты для этого инвентаря.

Фильтры обрабатываются последовательно до первого фильтра, где filters[].exclude или filters[].include совпадают. В случае совпадения filters[].exclude, хост исключается, а в случае совпадения filters[].include, хост включается. Если ни один фильтр не совпадает, хост включается.

exclude

строка

Условие Jinja2. Если оно совпадает для хоста, этот хост исключается.

Можно указать только одно из filters[].exclude и filters[].include.

include

строка

Условие Jinja2. Если оно совпадает для хоста, этот хост включается.

Можно указать только одно из filters[].exclude и filters[].include.

hetzner_token

алиасы: api_token

строка / обязательно

Токен для API Hetzner.

Если не указан, будет считан из переменной окружения HETZNER_DNS_TOKEN.

Настройка:

• Переменная окружения: HETZNER_DNS_TOKEN

plugin

строка / обязательно

Имя этого плагина. Должно всегда быть установлено в community.dns.hetzner_dns_records для распознавания плагина как собственного.

Варианты:

• "community.dns.hetzner_dns_records"

simple_filters

словарь

Словарь пар значений фильтров.

Этот параметр раньше назывался filters до community.dns 3.0.0. Он был переименован из filters в simple_filters в community.dns 2.8.0, и старое имя было доступно как псевдоним до community.dns 3.0.0. filters теперь используется для чего-то другого.

Значение по умолчанию: {}

type

список / элементы=строка

Типы записей, значения которых использовать.

Варианты:

• "A" ← (по умолчанию)
• "AAAA" ← (по умолчанию)
• "CAA"
• "CNAME" ← (по умолчанию)
• "DANE"
• "DS"
• "HINFO"
• "MX"
• "NS"
• "RP"
• "SOA"
• "SRV"
• "TLSA"
• "TXT"

Значение по умолчанию: ["A", "AAAA", "CNAME"]

txt_character_encoding

строка

добавлен в community.dns 2.5.0

Указывает, рассматривать ли числовые последовательности escape (\xyz) как восьмеричные или десятичные числа. Это используется только когда txt_transformation=quoted.

Значение по умолчанию было изменено на decimal в community.dns 3.0.0. Раньше значение по умолчанию было octal. Значение decimal совместимо с RFC 1035.

Варианты:

• "decimal" ← (по умолчанию)
• "octal"

txt_transformation

строка

Определяет, как преобразуются значения TXT-записей между API и вводом/выводом модуля.

Значение api означает, что значения возвращаются из этого модуля так, как они возвращаются из API, и передаются в API так, как они были переданы в этот модуль. Для проверок идемпотентности входная строка будет сравниваться со строками, возвращенными API. API может автоматически преобразовывать некоторые значения, например, разбивать длинные значения или добавлять кавычки, что может вызвать проблемы с идемпотентностью.

Значение unquoted автоматически преобразует значения, чтобы вы могли передавать необрамленные значения, а модуль вернет необрамленные значения. Если вы передаете значения в кавычках, они будут заключены в двойные кавычки.

Значение quoted автоматически преобразует значения так, что вам нужно использовать кавычки для значений, содержащих пробелы, символы, такие как кавычки и обратные слэши, и которые длиннее 255 байтов. Он также гарантирует возврат значений из API в нормализованной кодировке.

Значение по умолчанию, unquoted, гарантирует, что вы можете работать со значениями, не заботясь о правильном использовании кавычек для DNS. Большинству пользователей следует использовать unquoted или quoted, но не api.

Примечание: код преобразования предполагает кодировку UTF-8 для значений. Если вам нужна другая кодировка, используйте txt_transformation=api и обработайте кодировку самостоятельно.

Варианты:

• "api"
• "quoted"
• "unquoted" ← (по умолчанию)

zone_id

строка

Идентификатор зоны DNS для изменения.

Необходимо указать только одно из zone_name и zone_id.

zone_name

алиасы: zone

строка

Зона DNS для изменения.

Необходимо указать только одно из zone_name и zone_id.