netscaler_gslb_service – Управление сущностями службы gslb в Netscaler

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

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата
Статус

Описание

Управление сущностями службы gslb в Netscaler.

Требования

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

nitro python sdk

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
appflowlog -		Варианты: enabled disabled	Включить протоколирование информации о потоках appflow.
cip -		Варианты: enabled disabled	В запросе, пересылаемом службе GSLB, вставить заголовок, содержащий IP-адрес клиента. Вставка заголовка IP-адреса клиента используется при сохранении состояния сайта на основе прокси-сервера подключений.
cipheader -			Имя HTTP-заголовка, хранящего IP-адрес клиента. Используется с опцией Client IP. Если вставка заголовка IP-адреса клиента включена в службе и имя заголовка не указано, устройство NetScaler использует имя, заданное параметром cipHeader в команде set ns param или, в веб-интерфейсе, параметр Client IP Header в диалоговом окне Настройка параметров HTTP. Минимальная длина = 1
clttimeout -			Время бездействия в секундах, после которого соединение с клиентом закрывается. Применимо, если используется сохранение состояния сайта на основе прокси-сервера подключений. Минимальное значение = 0 Максимальное значение = 31536000
cnameentry -			Каноническое имя службы GSLB. Используется в GSLB на основе CNAME. Минимальная длина = 1
comment -			Любые комментарии, которые вы хотите связать со службой GSLB.
downstateflush -		Варианты: enabled disabled	Очистить все активные транзакции, связанные со службой GSLB, при изменении ее состояния с ВКЛ на ВЫКЛ. Не включайте эту опцию для служб, которые должны завершить свои транзакции. Применимо, если используется сохранение состояния сайта на основе прокси-сервера подключений.
hashid -			Уникальный идентификатор хеша для службы GSLB, используемый методами балансировки нагрузки на основе хеширования. Минимальное значение = `1`
healthmonitor boolean		Варианты: no yes	Отслеживать состояние службы 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
	monitor_name -		Имя монитора.
	weight -		Вес, назначаемый привязке монитор-служба. Большее число указывает больший вес. Вносит вклад в порог мониторинга, который определяет состояние службы. Минимальное значение = `1` Максимальное значение = `100`
monthreshold -			Порог мониторинга для службы GSLB. Если сумма весов мониторов, привязанных к этой службе GSLB и находящихся в состоянии ВКЛ, не равна или не больше этого порогового значения, служба помечается как ВЫКЛ. Минимальное значение = `0` Максимальное значение = `65535`
nitro_pass string / обязательно			Пароль для аутентификации на узле netscaler.
nitro_protocol string		Варианты: http ← https	Протокол для доступа к объектам API nitro.
nitro_timeout float		По умолчанию: 310	Время в секундах до ошибки таймаута при установлении нового сеанса с Netscaler
nitro_user string / обязательно			Имя пользователя для аутентификации на узле netscaler.
nsip string / обязательно			IP-адрес устройства netscaler, на котором будут выполняться вызовы API nitro. Порт можно указать с двоеточием (:). Например, 192.168.1.1:555.
port -			Порт, на котором слушается сущность балансировки нагрузки, представленная этой службой GSLB. Минимальное значение = 1 Диапазон 1 - 65535 * в CLI соответствует 65535 в NITRO API
publicip -			Общедоступный IP-адрес, к которому устройство NAT переводит частный IP-адрес службы GSLB. Необязательно.
publicport -			Общедоступный порт, связанный с общедоступным IP-адресом службы GSLB. Порт сопоставляется с частным номером порта службы. Применимо к локальной службе GSLB. Необязательно.
save_config boolean		Варианты: no yes ←	Если `yes`, модуль сохранит конфигурацию на узле netscaler, если он внес изменения. Модуль не сохранит конфигурацию на узле netscaler, если не было изменений.
servername -			Имя сервера, на котором размещена служба GSLB. Минимальная длина = 1
servicename -			Имя службы GSLB. Должно начинаться с буквенно-цифрового ASCII-символа или символа подчеркивания `_`, и должно содержать только буквенно-цифровые ASCII-символы, символ подчеркивания `_`, символ решётки `#`, точку `.`, пробел, двоеточие `:`, символ «@» `@`, знак равенства `=`, и тире `-` символы. Может быть изменено после создания службы GSLB. Минимальная длина = 1
servicetype -		Варианты: HTTP FTP TCP UDP SSL SSL_BRIDGE SSL_TCP NNTP ANY SIP_UDP SIP_TCP SIP_SSL RADIUS RDP RTSP MYSQL MSSQL ORACLE	Тип создаваемой службы.
sitename -			Имя сайта GSLB, к которому принадлежит служба. Минимальная длина = 1
sitepersistence -		Варианты: ConnectionProxy HTTPRedirect NONE	Использовать сохранение состояния сайта на основе cookie. Применимо только к `HTTP` и `SSL` службам GSLB.

siteprefix -		Префикс строки сайта. Когда служба связана с виртуальным сервером GSLB, домен сайта GSLB генерируется внутри для каждой связанной пары служба-домен путем конкатенации префикса сайта службы и имени домена. Если указана специальная строка NONE, строка префикса сайта сбрасывается. При реализации сохранения состояния сайта с помощью HTTP-перенаправления NetScaler-приложение перенаправляет запросы GSLB на службы GSLB, используя их домены сайта.
state string	Choices: absent present ←	Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла netscaler.
validate_certs boolean	Choices: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверяющие сертификаты.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами сети Citrix NetScaler см. в https://www.ansible.com/ansible-netscaler.

Примеры

- 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 dictionary	failure	Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Пример: { 'targetlbvserver': 'различие. ours: (str) server1 other: (str) server2' }
loglines list	всегда	список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2']
msg string	failure	Сообщение, подробно описывающее причину ошибки Пример: Действия не существует

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

George Nikolopoulos (@giorgos-nikolopoulos)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

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