Модуль community.network.netscaler_cs_policy – Управление политикой переключения содержимого

Примечание

Этот модуль является частью коллекции community.network (версия 5.0.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network. Для использования этого модуля требуются дополнительные компоненты. Подробнее см. раздел Требования.

Для использования в плейбуке укажите: community.network.netscaler_cs_policy.

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

Обзор

Управление политикой переключения содержимого.
Этот модуль предназначен для выполнения либо на узле управления Ansible, либо на башенном узле (прокси-сервере) с доступом к фактической инстанции NetScaler.

Псевдонимы: network.netscaler.netscaler_cs_policy

Требования

Ниже приведены требования к хосту, на котором выполняется этот модуль.

nitro python sdk

Параметры

Параметр	Комментарии
action строка	Действие переключения содержимого, которое задает целевой виртуальный сервер балансировки нагрузки, на который переключается трафик.
domain строка	Имя домена. Значение строки может составлять до 63 символов. Минимальная длина = 1
nitro_pass строка / обязательно	Пароль для аутентификации на узле NetScaler.
nitro_protocol строка	Протокол, который нужно использовать при доступе к объектам API nitro. Варианты: `"http"` ← (по умолчанию) `"https"`
nitro_timeout вещественное число	Время в секундах до сброса таймаута при установлении нового сеанса с NetScaler По умолчанию: `310.0`
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 логическое	Если `yes`, модуль сохранит конфигурацию на узле NetScaler, если внесёт какие-либо изменения. Модуль не сохранит конфигурацию на узле NetScaler, если не внесённых изменений. Варианты: `false` `true` ← (по умолчанию)
state строка	Состояние ресурса, настраиваемого модулем на узле NetScaler. При наличии ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При отсутствии ресурс будет удален с узла NetScaler. Варианты: `"absent"` `"present"` ← (по умолчанию)
url строка	Строка URL, которая сопоставляется с URL запроса. Может содержать символ подстановки. Укажите строковое значение в следующем формате: `[[prefix] [*]] [.suffix]`. Минимальная длина = 1 Максимальная длина = 208
validate_certs логическое	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами Citrix NetScaler Network см. на сайте https://www.ansible.com/ansible-netscaler.

Примеры

- name: Create url cs policy
  delegate_to: localhost
  community.network.netscaler_cs_policy:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot
    validate_certs: false

    state: present

    policyname: policy_1
    url: /example/

Значения возврата

Общие значения возврата документированы здесь, следующие — уникальные для данного модуля поля:

Ключ	Описание
diff словарь	Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Возвращается: при ошибке Пример: `{"url": "difference. ours: (str) example1 other: (str) /example1"}`
loglines список / элементы=строка	список сообщений, записанных модулем Возвращается: всегда Пример: `["message 1", "message 2"]`
msg строка	Сообщение, описывающее причину ошибки Возвращается: при ошибке Пример: `"Could not load nitro python sdk"`

Авторы

George Nikolopoulos (@giorgos-nikolopoulos)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/netscaler_cs_policy_module.html