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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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_endpoint_hetzner строка	Конечная точка API Hetzner. Этот параметр также можно задать с помощью переменной окружения `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token строка / обязательный	Токен для API Hetzner Cloud. Этот параметр также можно задать с помощью переменной окружения `HCLOUD_TOKEN`.
dns_ptr строка	DNS-адрес, на который должен указывать ip_address. Не указывайте этот параметр, чтобы сбросить запись обратного DNS до значения по умолчанию.
floating_ip строка	Имя или идентификатор Floating IP в Hetzner Cloud, для которого нужно добавить запись обратного DNS.
ip_address строка / обязательный	IP-адрес, который должен указывать на dns_ptr.
load_balancer строка	Имя или идентификатор Load Balancer в Hetzner Cloud, для которого нужно добавить запись обратного DNS.
primary_ip строка	Имя или идентификатор Primary IP в Hetzner Cloud, для которого нужно добавить запись обратного DNS.
server строка	Имя или идентификатор сервера Hetzner Cloud, для которого нужно добавить запись обратного DNS.
state строка	Состояние записи обратного DNS. Варианты: `"absent"` `"present"` ← (по умолчанию)

См. также

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

Примеры

- 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 строка	Имя Floating IP Возвращается: всегда Пример: `"my-floating-ip"`
ip_address строка	IP-адрес, указывающий на DNS ptr Возвращается: всегда Пример: `"123.123.123.123"`
load_balancer строка	Имя Load Balancer Возвращается: всегда Пример: `"my-load-balancer"`
primary_ip строка	Имя Primary IP Возвращается: всегда Пример: `"my-primary-ip"`
server строка	Имя сервера Возвращается: всегда Пример: `"my-server"`

Авторы

Lukas Kaemmerling (@lkaemmerling)

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

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