netscaler_cs_policy – Управление политикой переключения контента

Новое в версии 2.4.

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

Обзор

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

Требования

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

nitro python sdk

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
action -		Действие переключения контента, которое назначает целевой виртуальный сервер балансировки нагрузки, на который переключается трафик.
domain -		Имя домена. Строковое значение может содержать до 63 символов. Минимальная длина = 1
nitro_pass строка / обязательно		Пароль для аутентификации на узле netscaler.
nitro_protocol строка	Варианты: http ← https	Протокол, используемый при доступе к объектам 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 логическое значение	Варианты: нет да ←	Если `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 другой: (строка) /example1'}
loglines список	всегда	Список зарегистрированных сообщений модулем Пример: ['сообщение 1', 'сообщение 2']
msg строка	ошибка	Сообщение, описывающее причину ошибки Пример: Не удалось загрузить nitro python sdk

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Джордж Николопулос (@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.9/modules/netscaler_cs_policy_module.html