Модуль vmware.vmware_rest.appliance_networking_dns_servers — настройка конфигурации DNS-сервера

Примечание

Этот модуль входит в коллекцию vmware.vmware_rest (версия 4.10.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: vmware.vmware_rest.appliance_networking_dns_servers.

Добавлен в vmware.vmware_rest 2.0.0

УСТАРЕЛ
Краткое описание
Требования
Параметры
Примечания
См. также
Примеры
Возвращаемые значения
Статус

УСТАРЕЛ

Удалён в:: версии 5.0.0
Причина:: Этот модуль перенесён в новую коллекцию vmware.vmware
Альтернатива:: Вместо него используйте vmware.vmware.vcsa_settings.

Краткое описание

Настройка конфигурации DNS-сервера. Если для аргумента mode задано значение «DHCP», принудительно обновляется DHCP.

Требования

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

vSphere 7.0.3 или новее
python >= 3.6
aiohttp

Параметры

Параметр	Комментарии
mode строка	Перечисляемый тип dns_server_mode. Описывает источник DNS-сервера (DHCP, статический). Обязателен при state=[‘set’] Варианты: `"dhcp"` `"is_static"`
server строка	DNS-сервер. Обязателен при state=[‘add’]
servers список / элементы=строка	Список используемых в данный момент DNS-серверов. Обязателен при state=[‘set’, ‘test’]
session_timeout число с плавающей точкой добавлено в vmware.vmware_rest 2.1.0	Настройки времени ожидания для клиентского сеанса. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с.
state строка	Варианты: `"add"` `"set"` ← (по умолчанию) `"test"`
vcenter_hostname строка / обязательный	Имя хоста или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
vcenter_password строка / обязательный	Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
vcenter_rest_log_file строка	Этот необязательный параметр позволяет указать расположение файла журнала. Этот файл будет использоваться для записи взаимодействия HTTP REST. Файл будет сохранён на хосте, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_REST_LOG_FILE`.
vcenter_username строка / обязательный	Имя пользователя vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
vcenter_validate_certs логическое значение	Разрешает подключение при недействительных SSL-сертификатах. Если сертификаты не являются доверенными, задайте значение `false`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Проверено на vSphere 7.0.3

См. также

vmware.vmware.vcsa_settings: Настройка параметров vCenter Server Appliance.

Примеры

- name: Set static DNS servers
  vmware.vmware_rest.appliance_networking_dns_servers:
    servers:
    - 1.1.1.1
    mode: is_static
    state: set
  register: result

- name: Add another DNS server
  vmware.vmware_rest.appliance_networking_dns_servers:
    server: 8.8.4.4
    state: add
  register: result

- name: Use the DNS servers from the DHCP
  vmware.vmware_rest.appliance_networking_dns_servers:
    mode: dhcp
    servers: []
    state: set
  register: result

- name: Test the DNS servers
  vmware.vmware_rest.appliance_networking_dns_servers:
    state: test
    servers:
    - google.com
  register: result

Возвращаемые значения

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

Ключ	Описание
value словарь	Добавление другого DNS-сервера Возвращается: при успешном выполнении Пример: `{"mode": "is_static", "servers": ["1.1.1.1", "192.168.123.1", "8.8.4.4"]}`

Статус

Этот модуль будет удалён в версии 5.0.0. [устарел]
Дополнительную информацию см. в разделе УСТАРЕЛ.

Авторы

Команда Ansible Cloud (@ansible-collections)

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

© 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/vmware/vmware_rest/appliance_networking_dns_servers_module.html