Модуль cisco.ise.network_access_time_date_conditions – Модуль ресурсов для Условий времени и даты доступа в сеть

Примечание

Этот модуль является частью коллекции cisco.ise (версия 2.9.3).

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

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

Для использования в плейбуке укажите: cisco.ise.network_access_time_date_conditions.

Новая версия в cisco.ise 1.0.0

Описание
Требования
Параметры
Примечания
См. также
Примеры
Значения возврата

Описание

Управление операциями создания, обновления и удаления ресурсов Условий времени и даты доступа в сеть.
Доступ в сеть - Создает условие по времени/дате.
Доступ в сеть - Удаляет условие по времени/дате.
Доступ в сеть - Обновляет сетевое условие.

Примечание

Для этого модуля существует соответствующий плагин действий.

Требования

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

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
attributeId строка	Идентификатор атрибута словаря (необязательно), используемый для дополнительной проверки.
attributeName строка	Имя атрибута словаря.
attributeValue строка	<ul><li>Значение атрибута для условия</li> <li>Тип значения указан в объекте словаря</li> <li>Если разрешены несколько значений, это указано в объекте словаря</li></ul>.
children список / элементы=словарь	В случае, если тип — andBlock или orBlock, дополнительные условия будут агрегированы в рамках этого логического (ИЛИ/И) условия.
conditionType строка	<ul><li>Указывает, является ли запись самим условием (данные) или логическим (или, и) агрегированием</li> <li>Тип данных (ссылка, одиночное значение) указывает, что поля “conditonId” ИЛИ “ConditionAttrs” должны содержать данные условия, но не оба</li> <li>Логическое агрегирование (и, или) указывает, что дополнительные условия присутствуют в поле children</li></ul>.
isNegate логическое	Указывает, находится ли это условие в режиме отрицания. Варианты: `false` `true`
link словарь	Ссылка условий доступа по времени и дате.
href строка	href условий доступа по времени и дате.
rel строка	rel условий доступа по времени и дате.
type строка	Тип условий доступа по времени и дате.
conditionType строка	<ul><li>Указывает, является ли запись самим условием (данные) или логическим (или, и) агрегированием</li> <li>Тип данных (ссылка, одиночное значение) указывает, что поля “conditonId” ИЛИ “ConditionAttrs” должны содержать данные условия, но не оба</li> <li>Логическое агрегирование (и, или) указывает, что дополнительные условия присутствуют в поле children</li></ul>.
datesRange словарь	<p>Определяет, для каких дат условие времени и даты будет соответствовать или НЕ соответствовать, если используется в свойстве exceptionDates<br> Варианты - диапазон дат, для конкретной даты, та же дата должна использоваться для даты начала/окончания <br> По умолчанию - нет конкретных дат<br> Для сброса дат, чтобы не было конкретных дат, формат даты - yyyy-mm-dd (MM = месяц, dd = день, yyyy = год)</p>.
endDate строка	Конечная дата условий доступа по времени и дате.
startDate строка	Начальная дата условий доступа по времени и дате.
datesRangeException словарь	<p>Определяет, для каких дат условие времени и даты будет соответствовать или НЕ соответствовать, если используется в свойстве exceptionDates<br> Варианты - диапазон дат, для конкретной даты, та же дата должна использоваться для даты начала/окончания <br> По умолчанию - нет конкретных дат<br> Для сброса дат, чтобы не было конкретных дат, формат даты - yyyy-mm-dd (MM = месяц, dd = день, yyyy = год)</p>.
endDate строка	Конечная дата условий доступа по времени и дате.
startDate строка	Начальная дата условий доступа по времени и дате.
description строка	Описание условия.
dictionaryName строка	Имя словаря.
dictionaryValue строка	Значение словаря.
hoursRange словарь	<p>Определяет, в какие часы условие времени и даты будет соответствовать или не соответствовать, если используется в свойстве exceptionHours<br> Формат времени - ч чч ( ч = час, чч = минуты ) <br> По умолчанию - Весь день </p>.
endTime строка	Конечное время условий доступа по времени и дате.

startTime string	Начальное время условия доступа к сети по времени и дате.
hoursRangeException dictionary	<p>Определяет часы, для которых условие TimeAndDate будет соответствовать или не соответствовать, если используется свойство exceptionHours.<br> Формат времени - ч чч (ч = час, чч = минуты) <br> По умолчанию - Весь день </p>.
endTime string	Конечное время условия доступа к сети по времени и дате.
startTime string	Начальное время условия доступа к сети по времени и дате.
id string	Идентификатор условия доступа к сети по времени и дате.
ise_debug boolean	Флаг для включения отладки Identity Services Engine SDK. Варианты: `false` ← (по умолчанию) `true`
ise_hostname string / обязательно	Имя хоста Identity Services Engine.
ise_password string / обязательно	Пароль Identity Services Engine для аутентификации.
ise_single_request_timeout integer добавлен в cisco.ise 3.0.0	Таймаут (в секундах) для запросов RESTful HTTP. По умолчанию: `60`
ise_username string / обязательно	Имя пользователя Identity Services Engine для аутентификации.
ise_uses_api_gateway boolean добавлен в cisco.ise 1.1.0	Флаг, указывающий SDK, использовать ли шлюз API Identity Services Engine для отправки запросов. Если true, используется шлюз API ISE и отправляются запросы по адресу https://{{ise_hostname}}. Если false, запросы отправляются по адресу https://{{ise_hostname}}:{{port}}, где значение порта зависит от используемой службы (ERS, Mnt, UI, PxGrid). Варианты: `false` `true` ← (по умолчанию)
ise_uses_csrf_token boolean добавлен в cisco.ise 3.0.0	Флаг, указывающий SDK, отправлять ли токен CSRF в API ERS ISE. Если True, SDK предполагает, что проверка CSRF ISE включена. Если True, предполагается, что SDK должен автоматически управлять токеном CSRF. Варианты: `false` ← (по умолчанию) `true`
ise_verify boolean	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
ise_version string	Указывает SDK, какую версию Identity Services Engine использовать. По умолчанию: `"3.1_Patch_1"`
ise_wait_on_rate_limit boolean	Флаг для включения в Identity Services Engine SDK автоматической обработки лимита скорости. Варианты: `false` `true` ← (по умолчанию)
isNegate boolean	Указывает, используется ли это условие в режиме отрицания. Варианты: `false` `true`
link dictionary	Ссылка на условие доступа к сети по времени и дате.
href string	Ссылка условия доступа к сети по времени и дате.
rel string	Атрибут rel условия доступа к сети по времени и дате.
type string	Тип условия доступа к сети по времени и дате.

END_OF_DOCUMENT_MARKER

name string	Имя условия.
operator string	Оператор равенства.
weekDays list / elements=string	<p>Определяет, для каких дней данное условие будет соответствовать.<br> Формат дней - Массивы перечислений WeekDay.<br> По умолчанию - Список всех дней недели.</p>.
weekDaysException list / elements=string	<p>Определяет, для каких дней данное условие НЕ будет соответствовать.<br> Формат дней - Массивы перечислений WeekDay.<br> По умолчанию - Отключено.</p>.

Примечания

Примечание

Используемые методы SDK: network_access_time_date_conditions.NetworkAccessTimeDateConditions.create_network_access_time_condition, network_access_time_date_conditions.NetworkAccessTimeDateConditions.delete_network_access_time_condition_by_id, network_access_time_date_conditions.NetworkAccessTimeDateConditions.update_network_access_time_condition_by_id,
Используемые пути: post /network-access/time-condition, delete /network-access/time-condition/{id}, put /network-access/time-condition/{id},
Не поддерживает check_mode
Плагин работает на узле управления и не использует плагины подключения ansible, а вместо этого использует встроенный менеджер подключений Cisco ISE SDK
Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления соединения

См. также

Документация Cisco ISE для Условий времени/даты доступа к сети: Полное описание API Условий времени/даты доступа к сети.

Примеры

- name: Create
  cisco.ise.network_access_time_date_conditions:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    attributeId: string
    attributeName: string
    attributeValue: string
    children:
    - conditionType: string
      isNegate: true
      link:
        href: string
        rel: string
        type: string
    conditionType: string
    datesRange:
      endDate: string
      startDate: string
    datesRangeException:
      endDate: string
      startDate: string
    description: string
    dictionaryName: string
    dictionaryValue: string
    hoursRange:
      endTime: string
      startTime: string
    hoursRangeException:
      endTime: string
      startTime: string
    id: string
    isNegate: true
    link:
      href: string
      rel: string
      type: string
    name: string
    operator: string
    weekDays:
    - string
    weekDaysException:
    - string

- name: Update by id
  cisco.ise.network_access_time_date_conditions:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    attributeId: string
    attributeName: string
    attributeValue: string
    children:
    - conditionType: string
      isNegate: true
      link:
        href: string
        rel: string
        type: string
    conditionType: string
    datesRange:
      endDate: string
      startDate: string
    datesRangeException:
      endDate: string
      startDate: string
    description: string
    dictionaryName: string
    dictionaryValue: string
    hoursRange:
      endTime: string
      startTime: string
    hoursRangeException:
      endTime: string
      startTime: string
    id: string
    isNegate: true
    link:
      href: string
      rel: string
      type: string
    name: string
    operator: string
    weekDays:
    - string
    weekDaysException:
    - string

- name: Delete by id
  cisco.ise.network_access_time_date_conditions:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: absent
    id: string

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

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

Ключ	Описание
ise_response словарь	Словарь или список со значением, возвращенным Cisco ISE Python SDK Возвращается: всегда Пример: `{}`
ise_update_response словарь добавлен в cisco.ise 1.1.0	Словарь или список со значением, возвращенным Cisco ISE Python SDK Возвращается: всегда Пример: `{"response": {}, "version": "string"}`

Авторы

Rafael Campos (@racampos)

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

© 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/cisco/ise/network_access_time_date_conditions_module.html