netscaler_server - Управление конфигурацией сервера

Новая версия с 2.4.0.

Обзор
Требования (для хоста, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
- Статус

Обзор

Управление конфигурацией сущностей сервера.
Данный модуль предназначен для запуска на узле управления Ansible или бастионе (прокси-сервере) с доступом к фактической инстанции netscaler.

Требования (для хоста, на котором выполняется модуль)

nitro python sdk

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
comment	нет			Любая информация о сервере.
disabled	нет		да нет	При установке в `true` состояние сервера будет установлено в `disabled`. При установке в `false` состояние сервера будет установлено в `enabled`. Обратите внимание, что из-за ограничений в базовом API NITRO, изменение состояния `disabled` не приводит к тому, что модуль сообщает о статусе изменения.
domain	нет			Имя домена сервера. Для конфигурации на основе домена необходимо сначала создать сервер. Минимальная длина = 1
domainresolveretry	нет	5		Время в секундах, в течение которого устройство NetScaler должно ждать после неудачного разрешения DNS, прежде чем отправить следующий запрос DNS для разрешения имени домена. Минимальное значение = `5` Максимальное значение = `20939`
ipaddress	нет			Адрес IPv4 или IPv6 сервера. Если вы создаёте сервер на основе IP-адреса, вы можете указать имя сервера вместо его IP-адреса при создании сервиса. Примечание: Если вы не создаёте запись сервера, IP-адрес сервера, который вы вводите при создании сервиса, становится именем сервера.
ipv6address	нет		да нет	Поддержка режима адресации IPv6. Если вы настраиваете сервер с режимом адресации IPv6, вы не можете использовать сервер в режиме адресации IPv4.
name	нет			Имя сервера. Имя должно начинаться с буквенного или символа нижнего подчеркивания ASCII, и должно содержать только буквенно-цифровые ASCII, символы нижнего подчеркивания `_`, решётки `#`, точки `.`, пробелы, двоеточия `:`, знаки @ `@`, знаки = `=`, и дефисы `-`. Может быть изменено после создания имени. Минимальная длина = 1
nitro_pass	да			Пароль для аутентификации на узле netscaler.
nitro_protocol	нет	http	http https	Протокол для доступа к объектам API nitro.
nitro_timeout	нет	310		Время в секундах до истечения времени ожидания при установлении нового сеанса с Netscaler
nitro_user	да			Имя пользователя для аутентификации на узле netscaler.
nsip	да			IP-адрес устройства netscaler, на котором будут выполняться вызовы API nitro. Порт можно указать с помощью двоеточия (:). Например, 192.168.1.1:555.
save_config	нет	True	да нет	Если значение true, модуль сохранит конфигурацию на узле netscaler, если внесёт изменения. Модуль не сохранит конфигурацию на узле netscaler, если не внесёт изменений.
state	нет	present	present absent	Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан, если необходимо, и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удалён с узла netscaler.
td	нет			Целочисленное значение, уникально идентифицирующее домен трафика, в котором вы хотите настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика, который имеет идентификатор 0. Минимальное значение = `0` Максимальное значение = `4094`
translationip	нет			IP-адрес, используемый для преобразования IP-адреса сервера, полученного с помощью DNS.
translationmask	нет			Маска сети IP-адреса преобразования.
validate_certs	нет	да		Если `no`, сертификаты SSL не будут проверяться. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяемые сертификаты.

Примеры

- name: Setup server
  delegate_to: localhost
  netscaler_server:
      nsip: 172.18.0.2
      nitro_user: nsroot
      nitro_pass: nsroot

      state: present

      name: server-1
      ipaddress: 192.168.1.1

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

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

имя	описание	возвращается	тип	пример
diff	Список различий между фактическим конфигурируемым объектом и конфигурацией, указанной в модуле	ошибка	словарь	{'targetlbvserver': 'различие. наше: (строка) server1 другое: (строка) server2'}
loglines	список сообщений, записанных модулем	всегда	список	['сообщение 1', 'сообщение 2']
msg	Сообщение, описывающее причину ошибки	ошибка	строка	Действие не существует

Статус

Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.

Для получения помощи в разработке модулей, если вам это интересно, прочитайте Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/netscaler_server_module.html