Модуль hetzner.hcloud.rdns – Создание и управление записями обратного DNS на Hetzner Cloud.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 3.1.1).

Эта коллекция, возможно, уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.

Чтобы использовать его в плейбуке, укажите: hetzner.hcloud.rdns.

Описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Описание

Создание, обновление и удаление записей обратного DNS на Hetzner Cloud.

Псевдонимы: hcloud_rdns

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint строка	Конечная точка API Hetzner Cloud. Вы также можете установить этот параметр, используя переменную среды `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_token строка / обязательный	Токен API для Hetzner Cloud. Вы также можете установить этот параметр, используя переменную среды `HCLOUD_TOKEN`.
dns_ptr строка	Адрес DNS, к которому должен обращаться ip_address. Опустите параметр, чтобы сбросить запись обратного DNS до значения по умолчанию.
floating_ip строка	Имя или ID плавающего IP-адреса Hetzner Cloud, к которому вы хотите добавить запись обратного DNS.
ip_address строка / обязательный	IP-адрес, который должен указывать на dns_ptr.
load_balancer строка	Имя или ID балансировщика нагрузки Hetzner Cloud, к которому вы хотите добавить запись обратного DNS.
primary_ip строка	Имя или ID основного IP-адреса Hetzner Cloud, к которому вы хотите добавить запись обратного DNS.
server строка	Имя или ID сервера Hetzner Cloud, к которому вы хотите добавить запись обратного DNS.
state строка	Состояние записи обратного DNS. Варианты: `"absent"` `"present"` ← (по умолчанию)

См. также

Документация по API Hetzner Cloud: Полное руководство по API Hetzner Cloud.

Примеры

- name: Create a reverse DNS entry for a server
  hetzner.hcloud.rdns:
    server: my-server
    ip_address: 123.123.123.123
    dns_ptr: example.com
    state: present

- name: Create a reverse DNS entry for a Floating IP
  hetzner.hcloud.rdns:
    floating_ip: my-floating-ip
    ip_address: 123.123.123.123
    dns_ptr: example.com
    state: present

- name: Create a reverse DNS entry for a Primary IP
  hetzner.hcloud.rdns:
    primary_ip: my-primary-ip
    ip_address: 123.123.123.123
    dns_ptr: example.com
    state: present

- name: Create a reverse DNS entry for a Load Balancer
  hetzner.hcloud.rdns:
    load_balancer: my-load-balancer
    ip_address: 123.123.123.123
    dns_ptr: example.com
    state: present

- name: Ensure the reverse DNS entry is absent (remove if needed)
  hetzner.hcloud.rdns:
    server: my-server
    ip_address: 123.123.123.123
    dns_ptr: example.com
    state: absent

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
hcloud_rdns сложный	Запись обратного DNS Возвращается: всегда
dns_ptr строка	DNS, который разрешает IP-адрес Возвращается: всегда Пример: `"example.com"`
floating_ip строка	Имя плавающего IP-адреса Возвращается: всегда Пример: `"my-floating-ip"`
ip_address строка	IP-адрес, указывающий на DNS ptr Возвращается: всегда Пример: `"123.123.123.123"`
load_balancer строка	Имя балансировщика нагрузки Возвращается: всегда Пример: `"my-load-balancer"`
primary_ip строка	Имя первичного IP-адреса Возвращается: всегда Пример: `"my-primary-ip"`
server строка	Имя сервера Возвращается: всегда Пример: `"my-server"`

Авторы

Lukas Kaemmerling (@lkaemmerling)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/hetzner/hcloud/rdns_module.html