Spec-Zone.ru › Ansible

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

Примечание

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

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

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

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

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

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

Описание

  • Управление операциями создания, обновления и удаления ресурса Условия администрирования устройств.
  • Device Admin - Создает условие в библиотеке.
  • Device Admin - Удаляет условие из библиотеки.
  • NDevice Admin - Удаляет условие из библиотеки по имени.
  • Device Admin - Обновляет условие в библиотеке по имени.
  • Device Admin - Обновляет условие в библиотеке.

Примечание

Этот модуль имеет соответствующий плагин действий.

Требования

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

  • 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>Определяет, для каких дат условие TimeAndDate будет соответствовать или НЕ соответствовать, если используется в свойстве exceptionDates<br> Варианты — диапазон дат, для конкретной даты, для начала/окончания должна использоваться одна и та же дата<br> По умолчанию — нет конкретных дат<br> Для сброса дат на отсутствие конкретных дат Формат даты — гггг-мм-дд (мм = месяц, дд = день, гггг = год)</p>.

endDate

строка

Конечная дата Условий администрирования устройств.

startDate

строка

Начальная дата Условий администрирования устройств.

datesRangeException

словарь

<p>Определяет, для каких дат условие TimeAndDate будет соответствовать или НЕ соответствовать, если используется в свойстве exceptionDates<br> Варианты — диапазон дат, для конкретной даты, для начала/окончания должна использоваться одна и та же дата<br> По умолчанию — нет конкретных дат<br> Для сброса дат на отсутствие конкретных дат Формат даты — гггг-мм-дд (мм = месяц, дд = день, гггг = год)</p>.

endDate

строка

Конечная дата Условий администрирования устройств.

startDate

строка

Начальная дата Условий администрирования устройств.

description

строка

Описание условия.

dictionaryName

строка

Имя словаря.

dictionaryValue

строка

Значение словаря.

hoursRange

словарь

<p>Определяет, для каких часов условие TimeAndDate будет соответствовать или не соответствовать, если используется в свойстве exceptionHours<br> Формат времени — чч мм ( ч = час, мм = минуты ) <br> По умолчанию — Весь день </p>.

endTime

строка

Конечное время Условий администрирования устройств.

startTime

string

Начальное время Условий администрирования устройств.

hoursRangeException

dictionary

<p>Определяет, в какие часы условие TimeAndDate будет соответствовать или не соответствовать, если используется в свойстве exceptionHours.
Формат времени - чч мм (ч = час, мм = минуты).
По умолчанию - Весь день.</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

Отношение Условий администрирования устройств.

type

string

Тип Условий администрирования устройств.

name

string

Имя условия.

operator

string

Оператор сравнения.

weekDays

list / elements=string

Определяет, для каких дней будет проверяться это условие.
Формат дней — массивы перечислений WeekDay.
По умолчанию — список всех дней недели.

weekDaysException

list / elements=string

Определяет, для каких дней это условие НЕ будет проверяться.
Формат дней — массивы перечислений WeekDay.
По умолчанию — отключено.

Примечания

Примечание

  • Используемые методы SDK: device_administration_conditions.DeviceAdministrationConditions.create_device_admin_condition, device_administration_conditions.DeviceAdministrationConditions.delete_device_admin_condition_by_id, device_administration_conditions.DeviceAdministrationConditions.delete_device_admin_condition_by_name, device_administration_conditions.DeviceAdministrationConditions.update_device_admin_condition_by_id, device_administration_conditions.DeviceAdministrationConditions.update_device_admin_condition_by_name,
  • Используемые пути: post /device-admin/condition, delete /device-admin/condition/condition-by-name/{name}, delete /device-admin/condition/{id}, put /device-admin/condition/condition-by-name/{name}, put /device-admin/condition/{id},
  • Не поддерживает check_mode
  • Плагин работает на контрольном узле и не использует плагины подключения ansible, а вместо этого использует встроенный диспетчер подключений из Cisco ISE SDK
  • Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления подключения

См. также

См. также

Документация Cisco ISE по условиям администрирования устройств

Полная справка по API администрирования устройств — Условия.

Примеры

- name: Create
  cisco.ise.device_administration_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 name
  cisco.ise.device_administration_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 name
  cisco.ise.device_administration_conditions:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: absent
    name: string

- name: Update by id
  cisco.ise.device_administration_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.device_administration_conditions:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: absent
    id: string

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

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

Ключ

Описание

ise_response

dictionary

Словарь или список с ответом, возвращенным Cisco ISE Python SDK

Возвращается: всегда

Пример: {"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"]}

ise_update_response

dictionary

добавлен в cisco.ise 1.1.0

Словарь или список с ответом, возвращенным Cisco ISE Python SDK

Возвращается: всегда

Пример: {"response": {"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"]}, "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/device_administration_conditions_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API