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

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

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

Обзор

Управление политикой переключения содержимого.
Этот модуль предназначен для запуска либо на узле управления 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 boolean	Варианты: нет да ←	Если значение true, модуль сохранит конфигурацию на узле netscaler, если вносит какие-либо изменения. Модуль не сохранит конфигурацию на узле netscaler, если не вносил изменений.
state -	Варианты: present ← absent	Состояние ресурса, конфигурируемого модулем на узле 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
  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': 'различие. наше: (строка) example1 другое: (строка) /example1'}
loglines список	всегда	список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2']
msg строка	ошибка	Сообщение, описывающее причину ошибки Пример: Не удалось загрузить nitro python sdk

Статус

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

Авторы

Джордж Николопулос (@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.7/modules/netscaler_cs_policy_module.html