netscaler_gslb_service — Управление сущностями gslb-службы в Netscaler.
Новая версия с 2.4.
Описание
- Управление сущностями gslb-службы в Netscaler.
Требования (к хосту, на котором выполняется модуль)
- nitro python sdk
Параметры
| параметр | обязательный | по умолчанию | выбор | комментарии | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| appflowlog | нет |
| Включить протоколирование информации о потоках appflow. | ||||||||||||||||
| cip | нет |
| В запросе, пересылаемом службе GSLB, вставить заголовок, хранящий IP-адрес клиента. Вставка заголовка клиента IP используется при кэшировании сайтов на основе прокси-сервера соединения. | ||||||||||||||||
| cipheader | нет | Имя HTTP-заголовка, хранящего IP-адрес клиента. Используется с параметром Клиентский IP. Если вставка заголовка клиентского IP включена в службе, а имя для заголовка не указано, устройство NetScaler использует имя, указанное параметром cipHeader в команде set ns param или, в графическом интерфейсе, параметр Заголовок клиента IP в диалоговом окне «Настройка параметров HTTP». Минимальная длина = 1 | |||||||||||||||||
| clttimeout | нет | Время простоя, в секундах, после которого соединение с клиентом закрывается. Применимо, если используется кэширование сайтов на основе прокси-сервера соединения. Минимальное значение = 0 Максимальное значение = 31536000 | |||||||||||||||||
| cnameentry | нет | Каноническое имя службы GSLB. Используется в GSLB на основе CNAME. Минимальная длина = 1 | |||||||||||||||||
| comment | нет | Любые комментарии, которые вы хотите связать со службой GSLB. | |||||||||||||||||
| downstateflush | нет |
| Очистить все активные транзакции, связанные со службой GSLB, при изменении ее состояния с ВКЛ на ВЫКЛ. Не включайте этот параметр для служб, которые должны завершить свои транзакции. Применимо, если используется кэширование сайтов на основе прокси-сервера соединения. | ||||||||||||||||
| hashid | нет | Уникальный идентификатор хэша для службы GSLB, используемый методами балансировки нагрузки на основе хэша. Минимальное значение = 1 | |||||||||||||||||
| healthmonitor | нет |
| Отслеживать работоспособность службы GSLB. | ||||||||||||||||
| ipaddress | нет | IP-адрес службы GSLB. Должен представлять виртуальный сервер балансировки нагрузки, переключения содержимого или VPN на устройстве NetScaler или IP-адрес другого устройства балансировки нагрузки. | |||||||||||||||||
| maxaaausers | нет | Максимальное количество пользователей SSL VPN, которые могут быть одновременны подключены к VPN виртуальному серверу, который представлен этой службой GSLB. Служба GSLB, количество пользователей которой достигает максимума, не учитывается при принятии решения GSLB, пока количество не опустится ниже максимума. Минимальное значение = 0Максимальное значение = 65535 | |||||||||||||||||
| maxbandwidth | нет | Целое число, определяющее максимальную полосу пропускания, разрешенную для службы. Служба GSLB, полоса пропускания которой достигает максимума, не учитывается при принятии решения GSLB, пока ее потребление полосы пропускания не опустится ниже максимума. | |||||||||||||||||
| maxclient | нет | Максимальное количество открытых подключений, которые может поддерживать служба в любой момент времени. Служба GSLB, количество подключений которой достигает максимума, не учитывается при принятии решения GSLB, пока количество подключений не опустится ниже максимума. Минимальное значение = 0Максимальное значение = 4294967294 | |||||||||||||||||
| monitor_bindings | нет | Привязать мониторы к этой службе gslb |
|||||||||||||||||
| |||||||||||||||||||
| monthreshold | нет | Пороговое значение мониторинга для службы GSLB. Если сумма весов мониторов, привязанных к этой службе GSLB и находящихся в состоянии ВКЛ, не равна или не больше этого порогового значения, служба помечается как ВЫКЛ. Минимальное значение = 0Максимальное значение = 65535 | |||||||||||||||||
| nitro_pass | да | Пароль для аутентификации на узле netscaler. | |||||||||||||||||
| nitro_protocol | нет | http |
| Протокол для доступа к объектам API nitro. | |||||||||||||||
| nitro_timeout | нет | 310 | Время в секундах до появления ошибки тайм-аута при установлении нового сеанса с NetScaler | ||||||||||||||||
| nitro_user | да | Имя пользователя для аутентификации на узле netscaler. | |||||||||||||||||
| nsip | да | IP-адрес устройства NetScaler, к которому будут отправляться вызовы API nitro. Порт можно указать с помощью двоеточия (:). Например, 192.168.1.1:555. | |||||||||||||||||
| port | нет | Порт, на котором слушается сущность балансировки нагрузки, представленная этой службой GSLB. Минимальное значение = 1 Диапазон 1 - 65535 * в командной строке представлен как 65535 в API NITRO | |||||||||||||||||
| publicip | нет | Публичный IP-адрес, который устройство NAT преобразует в частный IP-адрес службы GSLB. Необязательно. | |||||||||||||||||
| publicport | нет | Публичный порт, связанный с публичным IP-адресом службы GSLB. Порт сопоставляется с частным номером порта службы. Применимо к локальной службе GSLB. Необязательно. | |||||||||||||||||
| save_config | нет | True |
| Если true, модуль сохранит конфигурацию на узле netscaler, если внесёт изменения. Модуль не сохранит конфигурацию на узле netscaler, если не внес изменений. | |||||||||||||||
| servername | нет | Имя сервера, на котором размещается служба GSLB. Минимальная длина = 1 | |||||||||||||||||
| servicename | нет | Имя службы GSLB. Должно начинаться с ASCII буквенно-цифрового символа или символа подчеркивания _, и должно содержать только ASCII буквенно-цифровые, символы подчеркивания _, решётки #, точки ., пробелы, двоеточия :, знаки «@» @, знаки «=» =, и дефисы - символы. Может быть изменено после создания службы GSLB.Минимальная длина = 1 | |||||||||||||||||
| servicetype | нет |
| Тип службы для создания. | ||||||||||||||||
| sitename | нет | Имя сайта GSLB, к которому принадлежит служба. Минимальная длина = 1 | |||||||||||||||||
| sitepersistence | нет |
| Использовать кэширование сайтов на основе файлов cookie. Применимо только к HTTP и SSL служба GSLB. | ||||||||||||||||
| siteprefix | нет | Строка префикса сайта. При привязке службы к виртуальному серверу GSLB, домен сайта GSLB генерируется внутри для каждой пары служба-домен, соединяя префикс сайта службы и имя домена. Если указана специальная строка NONE, строка префикса сайта отключается. При реализации кэширования сайтов с переадресацией HTTP, устройство NetScaler перенаправляет запросы GSLB к службам GSLB, используя их домены сайта. | |||||||||||||||||
| state | нет | present |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При absent ресурс будет удален с узла netscaler. | |||||||||||||||
| validate_certs | нет | yes | Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. | ||||||||||||||||
Примеры
- name: Setup gslb service 2
delegate_to: localhost
register: result
check_mode: "{{ check_mode }}"
netscaler_gslb_service:
operation: present
servicename: gslb-service-2
cnameentry: example.com
sitename: gslb-site-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_gslb_service_module.html