Модуль cisco.dnac.swim_intent – Модуль намерений для функций, связанных с SWIM

Примечание

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

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

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

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

Новая функция в cisco.dnac 6.6.0

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

Обзор

Управление операциями, связанными с импортом, распространением, активацией и маркировкой изображений как эталонных.
API для получения программного изображения из удаленной файловой системы с использованием URL для протоколов HTTP/FTP и загрузки его в Catalyst Center. Поддерживаются расширения файлов изображений: bin, img, tar, smu, pie, aes, iso, ova, tar_gz и qcow2.
API для получения программного изображения из локальной файловой системы и загрузки его в Catalyst Center. Поддерживаются расширения файлов изображений: bin, img, tar, smu, pie, aes, iso, ova, tar_gz и qcow2.
API для маркировки/снятия маркировки изображения как эталонного для заданной группы устройств.
API для распространения программного изображения на заданном устройстве. Программное изображение должно быть успешно импортировано в Catalyst Center перед распространением.
API для активации программного изображения на заданном устройстве. Программное изображение должно присутствовать во флеш-памяти устройства.

Требования

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

dnacentersdk == 2.4.5
python >= 3.9

Параметры

Параметр	Комментарии
config список / элементы=словарь / обязательно	Список деталей управляемого изображения SWIM
image_activation_details словарь	Подробности активации изображения SWIM. Устройство, на котором изображение должно быть активировано, может быть указано с помощью любого из следующих параметров: deviceSerialNumber, deviceIPAddress, deviceHostname или deviceMacAddress.
activate_lower_image_version булево	Флаг ActivateLowerImageVersion. Варианты: `false` `true`
device_family_name строка	Укажите имя семейства устройств, например, коммутаторы и концентраторы.
device_hostname строка	Имя хоста устройства, где необходимо активировать изображение.
device_ip_address строка	IP-адрес устройства, где необходимо активировать изображение.
device_mac_address строка	MAC-адрес устройства, где необходимо активировать изображение.
device_role строка	Определяет роль устройства, допустимые значения включают ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION и CORE. ALL — эта роль обычно представляет все устройства в сети, независимо от их конкретных ролей или функций. UNKNOWN — эта роль назначается устройствам, чьи роли или функции не были определены или классифицированы в Cisco Catalsyt Center. Это может произойти, если платформа не может определить роль устройства на основе имеющейся информации. ACCESS — эта роль обычно представляет коммутаторы или точки доступа, которые служат точками доступа для подключения устройств конечных пользователей к сети. Эти устройства часто находятся на периферии сети и обеспечивают подключение к устройствам конечных пользователей. BORDER ROUTER — это устройства, которые соединяют различные домены или сегменты сети. Они часто служат шлюзами между различными сетями, например, соединяя корпоративную сеть с интернетом или соединяя несколько филиалов. DISTRIBUTION — эта роль представляет функцию коммутаторов или маршрутизаторов распределения в иерархических сетевых проектах. Они агрегируют трафик с коммутаторов доступа и направляют его к ядру сети или к другим коммутаторам распределения. CORE — эта роль обычно представляет коммутаторы или маршрутизаторы высокой пропускной способности, образующие основную часть сети. Они обрабатывают большие объёмы трафика и обеспечивают подключение между различными частями сети, например, соединение коммутаторов распределения или предоставление взаимосвязи между различными сегментами сети.
device_serial_number строка	Серийный номер устройства, где необходимо активировать изображение.
device_upgrade_mode строка	Указывает режим обновления, который должен быть применён к устройствам, имеющим следующие значения: «install», «bundle» и «currentlyExists». install — этот режим сообщает Cisco Catalyst Center выполнить чистую установку нового изображения на целевые устройства. При выборе этого режима существующее изображение на устройстве полностью заменяется новым изображением во время процесса обновления. Это гарантирует, что устройство будет использовать только новую версию изображения после завершения обновления. bundle — этот режим сообщает Cisco Catalyst Center объединить новое изображение с существующим изображением на устройстве перед началом процесса обновления. Этот режим позволяет повысить эффективность процесса обновления, сохраняя существующее изображение на устройстве, одновременно добавляя новое изображение в качестве дополнительного пакета. После обновления устройство может использовать либо существующее изображение, либо новое объединённое изображение в зависимости от конфигурации. currentlyExists — этот режим сообщает Cisco Catalyst Center проверить, уже установлена ли целевым устройствам желаемая версия изображения. Если изображение уже присутствует на устройствах, никаких действий не выполняется, и процесс обновления пропускается для этих устройств. Этот режим полезен для предотвращения ненужных обновлений на устройствах, на которых уже установлена правильная версия изображения, тем самым экономя время.
distribute_if_needed булево	Включите параметр distribute_if_needed при активации изображения SWIM. Варианты: `false` `true`
image_name строка	Название изображения SWIM
schedule_validate булево	Параметр запроса ScheduleValidate. ScheduleValidate проверяет данные перед планированием (необязательно). Варианты: `false` `true`
site_name строка	Используется для получения данных устройства, связанных с этим сайтом.
image_distribution_details словарь	Подробности распространения изображения SWIM. Устройство, на которое должно быть распространено изображение, может быть указано с помощью любого из следующих параметров: deviceSerialNumber, deviceIPAddress, deviceHostname или deviceMacAddress.
device_family_name строка	Укажите имя семейства устройств, например, коммутаторы и концентраторы.
device_hostname строка	Имя хоста устройства, на которое необходимо распространить изображение.

END_OF_DOCUMENT_MARKER END_OF_DOCUMENT_MARKER

validate_response_schema

boolean

Флаг для Cisco DNA Center SDK, который включает проверку тел запросов на соответствие JSON-схеме.

Варианты:

false
true ← (по умолчанию)

Примечания

Примечание

Используемые методы SDK: software_image_management_swim.SoftwareImageManagementSwim.import_software_image_via_url, software_image_management_swim.SoftwareImageManagementSwim.tag_as_golden_image, software_image_management_swim.SoftwareImageManagementSwim.trigger_software_image_distribution, software_image_management_swim.SoftwareImageManagementSwim.trigger_software_image_activation,
Используемые пути: post /dna/intent/api/v1/image/importation/source/url, post /dna/intent/api/v1/image/importation/golden, post /dna/intent/api/v1/image/distribution, post /dna/intent/api/v1/image/activation/device,
В версии v6.13.2 добавлены параметры ‘dnac_api_task_timeout’, ‘dnac_task_poll_interval’.
Не поддерживает check_mode
Плагин работает на узле управления и не использует плагины подключения Ansible, а вместо этого использует встроенный менеджер подключения Cisco DNAC SDK
Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления соединения

Примеры

- name: Import an image from a URL, tag it as golden and load it on device
  cisco.dnac.swim_intent:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: True
    config:
    - import_image_details:
        type: remote
        url_details:
          payload:
          - source_url: "http://10.10.10.10/stda/cat9k_iosxe.17.12.01.SPA.bin"
            is_third_party: False
      tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: True
      image_distribution_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_serial_number: FJC2327U0S2
      image_activation_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        schedule_validate: False
        activate_lower_image_version: False
        distribute_if_needed: True
        device_serial_number: FJC2327U0S2

- name: Import an image from local, tag it as golden.
  cisco.dnac.swim_intent:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: True
    config:
    - import_image_details:
        type: local
        local_image_details:
            file_path: /Users/Downloads/cat9k_iosxe.17.12.01.SPA.bin
            is_third_party: False
      tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: True

- name: Tag the given image as golden and load it on device
  cisco.dnac.swim_intent:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: True
    config:
    - tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: True

- name: Un-tagged the given image as golden and load it on device
  cisco.dnac.swim_intent:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: True
    config:
    - tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: False

- name: Distribute the given image on devices associated to that site with specified role.
  cisco.dnac.swim_intent:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: True
    config:
    - image_distribution_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        site_name: Global/USA/San Francisco/BGL_18
        device_role: ALL
        device_family_name: Switches and Hubs
        device_series_name: Cisco Catalyst 9300 Series Switches

- name: Activate the given image on devices associated to that site with specified role.
  cisco.dnac.swim_intent:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: True
    config:
    - image_activation_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        site_name: Global/USA/San Francisco/BGL_18
        device_role: ALL
        device_family_name: Switches and Hubs
        device_series_name: Cisco Catalyst 9300 Series Switches
        scehdule_validate: False
        activate_lower_image_version: True
        distribute_if_needed: True

Возвращаемые значения

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

Ключ	Описание
response словарь	Словарь с подробностями активации, возвращенными Catalyst Center Python SDK Возвращается: всегда Пример: "{\n \"response\": {\n \"additionalStatusURL\": String,\n \"data\": String,\n \"endTime\": 0,\n \"id\": String,\n \"instanceTenantId\": String,\n \"isError\": bool,\n \"lastUpdate\": 0,\n \"progress\": String,\n \"rootId\": String,\n \"serviceType\": String,\n \"startTime\": 0,\n \"version\": 0\n },\n \"msg\": String\n}\n"

Ключ

Описание

response

словарь

Словарь с подробностями активации, возвращенными Catalyst Center Python SDK

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

Пример: "{\n \"response\": {\n \"additionalStatusURL\": String,\n \"data\": String,\n \"endTime\": 0,\n \"id\": String,\n \"instanceTenantId\": String,\n \"isError\": bool,\n \"lastUpdate\": 0,\n \"progress\": String,\n \"rootId\": String,\n \"serviceType\": String,\n \"startTime\": 0,\n \"version\": 0\n },\n \"msg\": String\n}\n"

Авторы

Madhan Sankaranarayanan (@madhansansel) Rishita Chowdhary (@rishitachowdhary) Abhishek Maheshwari (@abmahesh)

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

© 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/dnac/swim_intent_module.html

device_ip_address string	IP-адрес устройства, куда необходимо распространить образ.
device_mac_address string	MAC-адрес устройства, куда необходимо распространить образ.
device_role string	Определяет роль устройства, допустимые значения включают ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION и CORE. ALL - Эта роль, как правило, представляет все устройства в сети, независимо от их конкретных ролей или функций. UNKNOWN - Эта роль назначается устройствам, роли или функции которых не были идентифицированы или классифицированы в Cisco Catalsyt Center. Это может произойти, если платформа не может определить роль устройства на основе имеющейся информации. ACCESS - Эта роль, как правило, представляет собой коммутаторы или точки доступа, которые служат точками доступа для подключения устройств конечных пользователей к сети. Эти устройства часто расположены на периферии сети и обеспечивают подключение к устройствам конечных пользователей. BORDER ROUTER - Это устройства, которые соединяют различные домены или сегменты сети. Они часто служат шлюзами между различными сетями, например, соединяя корпоративную сеть с интернетом или соединяя несколько филиалов. DISTRIBUTION - Эта роль представляет функцию коммутаторов или маршрутизаторов распределения в иерархических сетевых проектах. Они агрегируют трафик от коммутаторов доступа и направляют его к ядру сети или к другим коммутаторам распределения. CORE - Эта роль, как правило, представляет собой коммутаторы или маршрутизаторы высокой пропускной способности, которые образуют основную часть сети. Они обрабатывают большие объемы трафика и обеспечивают подключение между различными частями сети, например, соединяя коммутаторы распределения или обеспечивая взаимосвязь между различными сетевыми сегментами.
device_serial_number string	Серийный номер устройства, куда необходимо распространить образ.
device_series_name string added in cisco.dnac 6.12.0	Этот параметр указывает имя серии устройств. Он используется для идентификации определенной серии устройств, например, коммутаторов Cisco Catalyst 9300 Series, в Cisco Catalyst Center.
image_name string	Имя образа SWIM.
site_name string	Используется для получения данных об устройствах, связанных с этим сайтом.
import_image_details dictionary	Подробности импортируемого образа.
local_image_details dictionary	Подробности локального пути к импортируемому образу.
file_path string	Укажите абсолютный путь к файлу для импорта образа с вашего локального компьютера (например, «/path/to/your/file»). Поддерживаются форматы файлов: .gz, .bin, .img, .tar, .smu, .pie, .aes, .iso, .ova, .tar_gz, .qcow2, .nfvispkg, .zip, .spa, .rpm.
is_third_party boolean	Параметр запроса для определения, является ли образ сторонним (необязательно). Варианты: `false` `true`
third_party_application_type string	Укажите параметр запроса ThirdPartyApplicationType для указания типа стороннего приложения. Допустимые значения включают WLC, LINUX, FIREWALL, WINDOWS, LOADBALANCER, THIRDPARTY и т.д. (необязательно). WLC (Wireless LAN Controller) — сетевое устройство, которое управляет и контролирует несколько беспроводных точек доступа (AP) в централизованном режиме. LINUX — это открытая операционная система, которая предоставляет полный набор программного обеспечения и утилит. FIREWALL — это сетевое устройство безопасности, которое отслеживает и контролирует входящий и исходящий сетевой трафик на основе предварительно определенных правил безопасности. Он действует как барьер между доверенной внутренней сетью и недоверенными внешними сетями (например, интернетом), предотвращая несанкционированный доступ. WINDOWS — это операционная система, известная своей поддержкой графического пользовательского интерфейса (GUI), широкой совместимостью с аппаратным и программным обеспечением и широким применением в различных приложениях. LOADBALANCER — это сетевое устройство или программное приложение, которое распределяет входящий сетевой трафик по нескольким серверам или ресурсам. THIRDPARTY — это сторонние образы или приложения, которые не являются частью основной системы. NAM (Network Access Manager) — это инструмент или программное приложение сетевого управления, которое обеспечивает централизованный контроль и мониторинг политик сетевого доступа, аутентификации пользователей и соответствия устройств. WAN Optimization — это методы и технологии, используемые для повышения производительности и эффективности сетей WAN. Они включают различные методы оптимизации, такие как сжатие данных, кэширование, оптимизация протоколов и приоритезация трафика для снижения задержки, повышения пропускной способности и улучшения пользовательского опыта в сетях WAN. Unknown — это неопределенный или нераспознанный тип приложения. Router — это сетевое устройство, которое пересылает пакеты данных между компьютерными сетями. Они необходимы для соединения нескольких сетей и перенаправления трафика между ними.
third_party_image_family string	Укажите параметр запроса ThirdPartyImageFamily для идентификации семейства стороннего образа. Имя семейства образа, например PALOALTO, RIVERBED, FORTINET, CHECKPOINT, SILVERPEAK и т.д. (необязательно).
third_party_vendor string	Включите параметр запроса ThirdPartyVendor для указания поставщика стороннего образа.
type string	Указывает источник импорта, поддерживаются локальный импорт файла (local) или импорт из удаленной ссылки (remote).
url_details dictionary	Подробности URL для импорта SWIM.

payload список / элементы=словарь	Загрузка SWIM-изображения по URL – полезная нагрузка.
application_type строка	Необязательный параметр, определяющий тип приложения. Допустимые значения включают WLC, LINUX, FIREWALL, WINDOWS, LOADBALANCER, THIRDPARTY и др. Применимо только для изображений сторонних производителей (необязательно). WLC (Wireless LAN Controller) – сетевое устройство, управляющее и контролирующее несколько беспроводных точек доступа (AP) централизованно. LINUX – это открытая система, предоставляющая полную операционную систему с широким спектром программных пакетов и утилит. FIREWALL – это сетевое устройство безопасности, контролирующее входящий и исходящий сетевой трафик на основе предварительно определённых правил безопасности. Оно служит барьером между надёжной внутренней сетью и ненадежной внешней сетью (например, интернетом), предотвращая несанкционированный доступ. WINDOWS – операционная система, предоставляющая графический интерфейс пользователя для различных приложений и широкую совместимость с оборудованием и программным обеспечением. LOADBALANCER – это сетевое устройство или программное приложение, распределяющее входящий сетевой трафик по нескольким серверам или ресурсам. THIRDPARTY – это изображения или приложения сторонних производителей, которые не являются частью основной системы. NAM (Network Access Manager) – инструмент или программное приложение для управления сетью, которое предоставляет централизованный контроль и мониторинг политик сетевого доступа, аутентификации пользователей и соответствия устройств. WAN Optimization – это методы и технологии, используемые для повышения производительности и эффективности сетей WAN. Это включает различные методы оптимизации, такие как сжатие данных, кэширование, оптимизация протоколов и приоритезация трафика для уменьшения задержки, увеличения пропускной способности и улучшения пользовательского опыта в сетях WAN. Unknown – это неопределённый или нераспознанный тип приложения. Router – сетевое устройство, пересылающее пакеты данных между компьютерными сетями. Они необходимы для объединения нескольких сетей и направления трафика между ними.
image_family строка	Представляет имя семейства изображений и применяется только при загрузке изображений сторонних производителей. Имя семейства изображений, например, PALOALTO, RIVERBED, FORTINET, CHECKPOINT, SILVERPEAK и т.д. (необязательно).
is_third_party логическое	Флаг указывает, загружается ли изображение от стороннего производителя (необязательно). Варианты: `false` `true`
source_url строка	Обязательный параметр для импорта SWIM-изображения по удалённому URL. Этот параметр требуется при импорте изображения по URL. (Например, http://{host}/swim/cat9k_isoxe.16.12.10s.SPA.bin, ftp://user:пароль@{host}/swim/cat9k_isoxe.16.12.10s.SPA.iso)
vendor строка	Название производителя, применимое только к изображениям сторонних производителей при импорте по URL (необязательно).
schedule_at строка	Параметр ScheduleAt. Эпоха (количество миллисекунд с 1 января 1970 г. по UTC), в которое должна быть запланирована рассылка (необязательно).
schedule_desc строка	Параметр ScheduleDesc. Пользовательское описание (необязательно).
schedule_origin строка	Параметр ScheduleOrigin. Инициатор этого вызова (необязательно).
tagging_details словарь	Подробности для маркировки или снятия маркировки изображения как золотого.
device_image_family_name строка	Имя семейства изображений устройства (например, Cisco Catalyst 9300 Switch).
device_role строка	Определяет роль устройства, допустимые значения включают ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION, CORE. ALL – эта роль обычно представляет все устройства в сети независимо от их конкретных ролей или функций. UNKNOWN – эта роль назначается устройствам, роли или функции которых не были определены или классифицированы в Cisco Catalsyt Center. Это может произойти, если платформа не может определить роль устройства на основе имеющейся информации. ACCESS – эта роль обычно представляет коммутаторы или точки доступа, которые служат точками доступа для подключения устройств конечных пользователей к сети. Эти устройства часто располагаются на границе сети и обеспечивают подключение к устройствам конечных пользователей. BORDER ROUTER – это устройства, которые соединяют разные домены или сегменты сетей. Они часто служат шлюзами между различными сетями, например, соединяют корпоративную сеть с интернетом или соединяют несколько филиалов. DISTRIBUTION – эта роль представляет функцию коммутаторов или маршрутизаторов распределения в иерархических сетевых проектах. Они агрегируют трафик от коммутаторов доступа и направляют его к ядру сети или к другим коммутаторам распределения. CORE – эта роль обычно представляет собой коммутаторы или маршрутизаторы высокой пропускной способности, которые образуют основу сети. Они обрабатывают большие объёмы трафика и обеспечивают соединение между разными частями сети, например, соединение коммутаторов распределения или подключение между различными сегментами сети.
device_series_name строка добавлено в cisco.dnac 6.12.0	Этот параметр указывает имя серии устройств. Он используется для идентификации конкретной серии устройств, таких как коммутаторы Cisco Catalyst 9300 Series, в центре Cisco Catalyst.
image_name строка	Имя SWIM-изображения, которое будет помечено или отмечено как золотое.
site_name строка	Имя сайта, для которого SWIM-изображение будет помечено/отмечено как золотое. Если не указано, SWIM-изображение будет сопоставлено с глобальным сайтом.

tagging boolean	Булево значение для маркировки/снятия метки изображения SWIM как золотого. Если True, то указанное изображение будет помечено как золотое. Если False, то указанное изображение будет снято с метки «золотое». Варианты: `false` `true`
config_verify boolean	Установите в значение True, чтобы проверить конфигурацию Cisco Catalyst Center после применения конфигурации playbook. Варианты: `false` ← (по умолчанию) `true`
dnac_api_task_timeout integer	Определяет таймаут в секундах для API-вызовов, чтобы получить детали задачи. Если детали задачи не получены в течение этого периода, процесс завершится, и уведомление о таймауте будет записано в журнал. По умолчанию: `1200`
dnac_debug boolean	Флаг для включения отладки Cisco DNA Center SDK. Варианты: `false` ← (по умолчанию) `true`
dnac_host string / обязательно	Имя хоста Cisco DNA Center.
dnac_log boolean	Флаг для включения/выключения ведения журнала выполнения playbook. При значении true и предоставленном dnac_log_file_path - Создает файл журнала в расположении выполнения с указанным именем. При значении true и отсутствии dnac_log_file_path - Создает файл журнала в расположении выполнения с именем ‘dnac.log’. При значении false - Ведение журнала отключено. Если файл журнала не существует - Создается в режиме добавления или записи в зависимости от флага “dnac_log_append”. Если файл журнала существует - Перезаписывается или добавляется в зависимости от флага “dnac_log_append”. Варианты: `false` ← (по умолчанию) `true`
dnac_log_append boolean	Определяет режим файла. Установите в True для режима ‘добавления’. Установите в False для режима ‘записи’. Варианты: `false` `true` ← (по умолчанию)
dnac_log_file_path string	Управляет ведением журнала. Журналы записываются, если dnac_log имеет значение True. Если путь не указан - При ‘dnac_log_append’ равном True, ‘dnac.log’ генерируется в текущем каталоге Ansible; логи добавляются. При ‘dnac_log_append’ равном False, ‘dnac.log’ генерируется; логи перезаписываются. Если путь указан - При ‘dnac_log_append’ равном True, файл открывается в режиме добавления. При ‘dnac_log_append’ равном False, файл открывается в режиме записи (w). В сценариях с общим файлом, без режима добавления, содержимое перезаписывается после каждого выполнения модуля. Для общего файла журнала, установите режим добавления в False для первого модуля (перезапись); для последующих модулей установите режим добавления в True. По умолчанию: `"dnac.log"`
dnac_log_level string	Устанавливает порог уровня журнала. Сообщения с уровнем, равным или большим этому, будут записаны в журнал. Уровни перечислены в порядке убывания серьезности [CRITICAL, ERROR, WARNING, INFO, DEBUG]. CRITICAL указывает серьезные ошибки, останавливающие программу. Отображаются только сообщения CRITICAL. ERROR указывает проблемы, препятствующие работе функции. Отображаются сообщения ERROR и CRITICAL. WARNING указывает потенциальные будущие проблемы. Отображаются сообщения WARNING, ERROR, CRITICAL. INFO отслеживает нормальную работу. Отображаются сообщения INFO, WARNING, ERROR, CRITICAL. DEBUG предоставляет подробную диагностическую информацию. Отображаются все сообщения журнала. По умолчанию: `"WARNING"`
dnac_password string	Пароль Cisco DNA Center для аутентификации.
dnac_port string	Порт Cisco DNA Center. По умолчанию: `"443"`
dnac_task_poll_interval integer	Указывает интервал в секундах между последовательными вызовами API для получения деталей задачи. По умолчанию: `2`
dnac_username псевдонимы: user string	Имя пользователя Cisco DNA Center для аутентификации. По умолчанию: `"admin"`
dnac_verify boolean	Флаг для включения или выключения проверки сертификатов SSL. Варианты: `false` `true` ← (по умолчанию)
dnac_version string	Информирует SDK, какую версию Cisco DNA Center использовать. По умолчанию: `"2.2.3.3"`
state string	Состояние Catalyst Center после завершения модуля. Варианты: `"merged"` ← (по умолчанию)