community.network.netscaler_cs_policy – Управление политикой переключения содержимого

Примечание

Этот плагин входит в коллекцию community.network (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.network.

Чтобы использовать его в плейбуке, укажите: community.network.netscaler_cs_policy.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление политикой переключения содержимого.
Этот модуль предназначен для запуска либо на контрольном узле Ansible, либо на бастионе (сервере-шлюзе) с доступом к фактическому экземпляру NetScaler.

Требования

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

nitro python sdk

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
action строка		Действие переключения содержимого, которое задаёт целевой виртуальный сервер балансировки нагрузки, на который переключается трафик.
domain строка		Имя домена. Строковое значение может содержать до 63 символов. Минимальная длина = 1
nitro_pass строка / обязательно		Пароль для аутентификации на узле NetScaler.
nitro_protocol строка	Варианты: http ← https	Протокол для доступа к объектам API nitro.
nitro_timeout число с плавающей точкой	По умолчанию: 310	Время в секундах до возникновения ошибки таймаута при установлении нового сеанса с NetScaler.
nitro_user строка / обязательно		Имя пользователя для аутентификации на узле NetScaler.
nsip строка / обязательно		IP-адрес устройства NetScaler, на котором будут выполняться вызовы API nitro. Порт можно указать с двоеточием (:). Например, 192.168.1.1:555.
policyname строка		Имя политики переключения содержимого. Должно начинаться с ASCII буквенно-цифрового символа или символа нижнего подчеркивания `_`, и должно содержать только ASCII буквенно-цифровые символы, символы нижнего подчеркивания, решётки `#`, точки `.`, пробелы, двоеточия `:`, знаки «@» `@`, знаки «=» `=`, и дефисы `-`. Не может быть изменено после создания политики. Следующее требование применимо только к NetScaler CLI: Если имя содержит один или несколько пробелов, заключите имя в двойные или одинарные кавычки (например, моя политика или моя политика). Минимальная длина = 1
rule строка		Выражение или имя именованного выражения, на основании которого оценивается трафик. Записано в классическом или стандартном синтаксисе. Примечание: Максимальная длина строковой литералы в выражении составляет 255 символов. Более длинную строку можно разбить на более короткие строки по 255 символов каждая и объединить их с помощью оператора +. Например, можно создать строку из 500 символов следующим образом: '"<строка из 255 символов>" + "<строка из 245 символов>"'
save_config булево	Варианты: нет да ←	Если `yes`, модуль сохранит конфигурацию на узле NetScaler, если внесёт какие-либо изменения. Модуль не сохранит конфигурацию на узле NetScaler, если не внесёт никаких изменений.
state строка	Варианты: absent present ←	Состояние ресурса, настраиваемого модулем на узле NetScaler. При значении present ресурс будет создан, если необходимо, и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удалён с узла NetScaler.
url строка		Строка URL, которая сопоставляется с URL запроса. Может содержать символ подстановки. Укажите строковое значение в следующем формате: `[[prefix] [*]] [.suffix]`. Минимальная длина = 1 Максимальная длина = 208
validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов.

Примечания

Примечание

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

Примеры

- name: Create url cs policy
  delegate_to: localhost
  community.network.netscaler_cs_policy:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot
    validate_certs: no

    state: present

    policyname: policy_1
    url: /example/

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

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

Ключ	Возвращаемое значение	Описание
diff словарь	неудача	Список различий между фактическим настроенным объектом и конфигурацией, указанной в модуле Пример: {'url': 'различие. наше: (строка) пример1 другой: (строка) /example1'}
loglines список / элементы=строка	всегда	Список сообщений журнала, записанных модулем Пример: ['сообщение 1', 'сообщение 2']
msg строка	неудача	Сообщение, описывающее причину неудачи Пример: Не удалось загрузить nitro python sdk

Авторы

George Nikolopoulos (@giorgos-nikolopoulos)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/netscaler_cs_policy_module.html