netscaler_cs_policy - Управление политикой переключения содержимого
Новая версия 2.4.
Обзор
- Управление политикой переключения содержимого.
- Этот модуль предназначен для выполнения либо на узле управления Ansible, либо на бастионе (прокси-сервере) с доступом к фактической инстанции netscaler.
Требования (к хосту, на котором выполняется модуль)
- nitro python sdk
Параметры
| параметр | обязательно | значение по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| action | нет | Действие переключения содержимого, которое называет целевой виртуальный сервер балансировки нагрузки, на который переключается трафик. | ||
| domain | нет | Имя домена. Строковое значение может содержать до 63 символов. Минимальная длина = 1 | ||
| 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. | ||
| policyname | нет | Имя политики переключения содержимого. Должно начинаться с ASCII буквенно-цифрового символа или символа подчеркивания _, и должно содержать только ASCII буквенно-цифровые символы, символ подчеркивания, символ решетки #, точку ., пробел, двоеточие :, символ @ @, знак равенства =, и дефис - символы. Не может быть изменено после создания политики.Следующее требование относится только к интерфейсу командной строки NetScaler: Если имя включает один или несколько пробелов, заключите имя в двойные или одинарные кавычки (например, моя политика или моя политика). Минимальная длина = 1 | ||
| rule | нет | Выражение или имя именованного выражения, на основе которого оценивается трафик. Записано в классическом или стандартном синтаксисе. Примечание: Максимальная длина строкового литерала в выражении составляет 255 символов. Более длинную строку можно разбить на более короткие строки до 255 символов каждая, и объединить эти строки оператором +. Например, вы можете создать строку из 500 символов следующим образом: '"<строка из 255 символов>" + "<строка из 245 символов>"' | ||
| save_config | нет | True |
| Если значение true, модуль сохранит конфигурацию на узле netscaler, если внесёт изменения. Модуль не сохранит конфигурацию на узле netscaler, если не внесёт изменений. |
| state | нет | present |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла netscaler. |
| url | нет | Строка URL, которая сопоставляется с URL запроса. Может содержать символ подстановки. Укажите строковое значение в следующем формате: [[prefix] [*]] [.suffix].Минимальная длина = 1 Максимальная длина = 208 | ||
| validate_certs | нет | да | Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с использованием самозаверенных сертификатов. |
Примеры
- 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 и Разработка модулей.
© 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_cs_policy_module.html