netscaler_cs_policy – Управление политикой переключения содержимого
Новая версия 2.4.
Обзор
- Управление политикой переключения содержимого.
- Этот модуль предназначен для выполнения либо на узле управления Ansible, либо на бастионе (шлюзе) с доступом к фактической инстанции Netscaler.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Nitro Python SDK
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| action - | Действие переключения содержимого, которое назначает целевой виртуальный сервер балансировки нагрузки, на который переключается трафик. | |
| domain - | Имя домена. Строковое значение может достигать 63 символов. Минимальная длина = 1 | |
| nitro_pass строка / обязательно | Пароль для аутентификации на узле Netscaler. | |
| nitro_protocol строка |
| Протокол, используемый при доступе к объектам API Nitro. |
| nitro_timeout число с плавающей запятой | Значение по умолчанию: 310 | Время в секундах до сброса тайм-аута при установлении нового сеанса с Netscaler |
| nitro_user строка / обязательно | Имя пользователя для аутентификации на узле Netscaler. | |
| nsip строка / обязательно | IP-адрес устройства Netscaler, на котором будут выполняться вызовы API Nitro. Порт может быть указан с двоеточием (:). Например, 192.168.1.1:555. | |
| policyname - | Имя политики переключения содержимого. Должно начинаться с ASCII буквенно-цифрового символа или символа подчеркивания _, и должно содержать только ASCII буквенно-цифровые символы, символы подчеркивания, диезы #, точки ., пробелы , двоеточия :, знаки «@» @, знаки «=» =, и дефисы - символы. Не может быть изменено после создания политики.Следующее требование применяется только к CLI NetScaler: Если имя содержит один или несколько пробелов, заключите имя в двойные или одинарные кавычки (например, моя политика или моя политика). Минимальная длина = 1 | |
| rule - | Выражение или имя именованного выражения, по которому оценивается трафик. Записано в классическом или стандартном формате. Примечание: Максимальная длина строковой константы в выражении составляет 255 символов. Более длинную строку можно разбить на более короткие строки по 255 символов и объединить их оператором «+». Например, вы можете создать строку длиной 500 символов следующим образом: '"<строка длиной 255 символов>" + "<строка длиной 245 символов>"' | |
| save_config булево |
| Если yes модуль сохранит конфигурацию на узле netscaler, если внесет какие-либо изменения.Модуль не сохранит конфигурацию на узле netscaler, если не внес никаких изменений. |
| state строка |
| Состояние ресурса, настраиваемого модулем на узле Netscaler. При значении «присутствует» ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении «отсутствует» ресурс будет удален с узла 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': 'различие. наше: (строка) пример1 другое: (строка) /пример1'} |
| loglines список | всегда | список сообщений журнала, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | ошибка | Сообщение, описывающее причину ошибки Пример: Не удалось загрузить nitro python sdk |
Статус
- Не гарантируется обратная совместимость интерфейса этого модуля. [предварительный просмотр]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/netscaler_cs_policy_module.html