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 буквенно-цифровые символы, символы подчеркивания, решетки #, точки ., пробелы , двоеточия :, знаки @ @, знаки = =, и дефисы - символы. Не может быть изменено после создания политики.Следующее требование относится только к NetScaler CLI: Если имя включает один или несколько пробелов, заключите имя в двойные или одинарные кавычки (например, моя политика или моя политика). Минимальная длина = 1 | |
| rule | Выражение или имя именованного выражения, по которому оценивается трафик. Записано в классическом или стандартном синтаксисе. Примечание: Максимальная длина строкового литерала в выражении составляет 255 символов. Более длинную строку можно разделить на более короткие строки по 255 символов каждая и объединить их оператором +. Например, вы можете создать строку из 500 символов следующим образом: '"<строка из 255 символов>" + "<строка из 245 символов>"' | |
| save_config |
| Если значение true, модуль сохранит конфигурацию на узле netscaler, если в ней были внесены изменения. Модуль не сохранит конфигурацию на узле netscaler, если изменения не были внесены. |
| state |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла netscaler. |
| url | Строка URL, которая сопоставляется с URL запроса. Может содержать символ подстановки. Укажите строковое значение в следующем формате: [[prefix] [*]] [.suffix].Минимальная длина = 1 Максимальная длина = 208 | |
| validate_certs | Значение по умолчанию: yes | Если 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 |
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- 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.5/modules/netscaler_cs_policy_module.html