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 bool |
| Если значение 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 dict | ошибка | Список различий между фактическим настроенным объектом и конфигурацией, указанной в модуле Пример: {'url': 'различие. наше: (str) example1 другое: (str) /example1'} |
| loglines список | всегда | список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg str | ошибка | Сообщение, описывающее причину ошибки Пример: Не удалось загрузить nitro python sdk |
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробнее см. на странице Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом 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.6/modules/netscaler_cs_policy_module.html