Модуль cisco.dnac.swim_workflow_manager – Управление операциями SWIM (Software Image Management) в Cisco Catalyst Center

Примечание

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

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

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

Для использования в книге команд укажите: cisco.dnac.swim_workflow_manager.

Новый в cisco.dnac 6.6.0

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

Описание

Управляет операциями импорта, распространения, активации и маркировки изображений как образцовых.
Предоставляет API для получения образа программного обеспечения из удаленной файловой системы через 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 для получения образа программного обеспечения из Cisco Connection Online (CCO) и загрузки его в Catalyst Center. Обратитесь к https://software.cisco.com/download/home для получения предложенных образов в Cisco Catalyst Center. Функциональность CCO доступна начиная с версии Cisco Catalyst 2.3.7.6.
Предоставляет API для маркировки или снятия маркировки образа как образцового для заданной серии устройств.
Предоставляет API для распространения образа программного обеспечения на устройство. Образ программного обеспечения должен быть импортирован в Catalyst Center перед распространением.

Требования

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

dnacentersdk == 2.7.3
python >= 3.9

Параметры

Параметр	Комментарии
config list / elements=dictionary / required	Список подробностей управляемого образа SWIM
image_activation_details dictionary	Подробности для активации образа SWIM. Устройство, на котором необходимо активировать образ, может быть указано с помощью любого из следующих параметров: deviceSerialNumber, deviceIPAddress, deviceHostname или deviceMacAddress.
activate_lower_image_version boolean	Флаг ActivateLowerImageVersion. Варианты: `false` `true`
device_family_name string	Укажите имя семейства устройств, например, коммутаторы и концентраторы и т.д.
device_hostname string	Имя хоста устройства, на котором необходимо активировать образ
device_ip_address string	IP-адрес устройства, на котором необходимо активировать образ
device_mac_address string	MAC-адрес устройства, на котором необходимо активировать образ
device_role string	Определяет роль устройства с допустимыми значениями, включая ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION и CORE.
device_serial_number string	Серийный номер устройства, на котором необходимо активировать образ
device_series_name string added in cisco.dnac 6.12.0	Этот параметр указывает имя серии устройств. Он используется для идентификации конкретной серии устройств, таких как коммутаторы серии Cisco Catalyst 9300, в Cisco Catalyst Center.
device_upgrade_mode string	Указывает режим обновления, который будет применен к устройствам со следующими значениями: «install», «bundle» и «currentlyExists». install - Этот режим предписывает Cisco Catalyst Center выполнить чистую установку нового образа на целевых устройствах. Когда выбран этот режим, существующий образ на устройстве полностью заменяется новым образом во время процесса обновления. Это гарантирует, что устройство работает только с новой версией образа после завершения обновления. bundle - Этот режим предписывает Cisco Catalyst Center объединить новый образ с существующим образом на устройстве перед началом процесса обновления. Этот режим обеспечивает более эффективный процесс обновления, сохраняя существующий образ на устройстве, добавляя новый образ в качестве дополнительного пакета. После обновления устройство может использовать либо существующий образ, либо новый объединенный образ, в зависимости от конфигурации. currentlyExists - Этот режим предписывает Cisco Catalyst Center проверить, установлена ли на целевых устройствах уже нужная версия образа. Если образ уже присутствует на устройствах, никаких действий не предпринимается, и процесс обновления пропускается для этих устройств. Этот режим полезен для предотвращения ненужных обновлений на устройствах, на которых уже установлена правильная версия образа, что экономит время.
distribute_if_needed boolean	Включите параметр distribute_if_needed при активации образа SWIM. Варианты: `false` `true`
image_name string	Имя образа SWIM
schedule_validate boolean	Параметр запроса ScheduleValidate. ScheduleValidate проверяет данные перед планированием (необязательно). Варианты: `false` `true`
site_name string	Используется для получения сведений об устройстве, связанных с этим сайтом.
image_distribution_details dictionary	Подробности для распространения образа SWIM. Устройство, на которое необходимо распространить образ, может быть указано с помощью любого из следующих параметров: deviceSerialNumber, deviceIPAddress, deviceHostname или deviceMacAddress.
device_family_name string	Укажите имя семейства устройств, например, коммутаторы и концентраторы и т.д.
device_hostname string	Имя хоста устройства, на которое необходимо распространить образ
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	Подробная информация об импортируемом образе
cco_image_details dictionary	Параметры, связанные с импортом программного образа из Cisco Connection Online (CCO) в Catalyst Center. Этот API извлекает указанный образ из CCO и загружает его в Catalyst Center. Поддерживается начиная с версии Cisco Catalyst Center 2.3.7.6. Рекомендуемые образы см. на портале загрузки программного обеспечения Cisco (https://software.cisco.com/download/home).
image_name dictionary	Имя программного образа, который необходимо импортировать с Cisco.com. Это обязательный параметр, который необходимо указать для начала загрузки из CCO.
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 (контроллер беспроводной локальной сети) - это сетевое устройство, которое централизованно управляет и контролирует несколько беспроводных точек доступа (AP). LINUX - это операционная система с открытым исходным кодом, которая предоставляет полный набор программных пакетов и утилит. FIREWALL - это сетевое устройство безопасности, которое контролирует и управляет входящим и исходящим сетевым трафиком на основе предопределенных правил безопасности. Он выступает в качестве барьера между надежной внутренней сетью и ненадежной внешней сетью (например, Интернетом), предотвращая несанкционированный доступ. WINDOWS - это операционная система, известная своей поддержкой графического интерфейса пользователя (GUI), широкой совместимостью с аппаратным и программным обеспечением и широким использованием в различных приложениях. LOADBALANCER - это сетевое устройство или программное приложение, которое распределяет входящий сетевой трафик между несколькими серверами или ресурсами. THIRDPARTY - относится к сторонним образам или приложениям, которые не являются частью основной системы. NAM (Network Access Manager) - это инструмент или программное приложение для управления сетью, которое обеспечивает централизованное управление и мониторинг политик доступа к сети, аутентификации пользователей и соответствия устройств. Оптимизация WAN - относится к методам и технологиям, используемым для повышения производительности и эффективности 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, или ‘CCO’ для импорта из Cisco Connection Online.
url_details dictionary	Подробности URL для импорта SWIM.
payload list / elements=dictionary	Данные для импорта SWIM через URL.
application_type string	Необязательный параметр, определяющий тип приложения. Допустимые значения включают WLC, LINUX, FIREWALL, WINDOWS, LOADBALANCER, THIRDPARTY и т.д. Применимо только для изображений сторонних разработчиков (необязательно). WLC (Wireless LAN Controller) — сетевое устройство, которое управляет и контролирует множество беспроводных точек доступа (AP) централизованно. LINUX — это свободное программное обеспечение, предоставляющее полную операционную систему с широким спектром программных пакетов и утилит. FIREWALL — это сетевое устройство безопасности, которое отслеживает и контролирует входящий и исходящий сетевой трафик на основе предопределенных правил безопасности. Оно служит барьером между доверенной внутренней сетью и недоверенной внешней сетью (например, интернетом), предотвращая несанкционированный доступ. WINDOWS — это операционная система, предоставляющая графический интерфейс пользователя для различных приложений и широкую совместимость с аппаратным и программным обеспечением. LOADBALANCER — это сетевое устройство или программное приложение, которое распределяет входящий сетевой трафик между несколькими серверами или ресурсами. THIRDPARTY — относится к изображениям или приложениям сторонних разработчиков, которые не входят в состав основной системы. NAM (Network Access Manager) — инструмент или программное приложение для управления сетью, обеспечивающее централизованный контроль и мониторинг сетевых политик, аутентификации пользователей и соответствия устройств. Оптимизация WAN — относится к методам и технологиям повышения производительности и эффективности WAN. Включает различные методы оптимизации, такие как сжатие данных, кэширование, оптимизация протоколов и приоритезация трафика, чтобы снизить задержки, увеличить пропускную способность и улучшить пользовательский опыт в WAN-соединениях. Unknown — относится к неопределённому или нераспознанному типу приложения. Router — сетевое устройство, которое пересылает пакеты данных между компьютерными сетями. Они необходимы для соединения нескольких сетей и направления трафика между ними.
image_family string	Представляет имя семейства изображений и применимо только при загрузке изображений сторонних разработчиков. Имя семейства изображений, таких как PALOALTO, RIVERBED, FORTINET, CHECKPOINT, SILVERPEAK и т.д. (необязательно).
is_third_party boolean	Флаг указывает, загружено ли изображение от стороннего разработчика (необязательно). Варианты: `false` `true`
source_url list / elements=string	Обязательный параметр для импорта изображения SWIM через удалённый URL. Этот параметр необходим при использовании URL для импорта изображения..(Например, http://{host}/swim/cat9k_isoxe.16.12.10s.SPA.bin, ftp://user:password@{host}/swim/cat9k_isoxe.16.12.10s.SPA.iso)
vendor string	Название поставщика, применимо только к изображениям сторонних разработчиков при импорте через URL (необязательно).
schedule_at string	Параметр запроса ScheduleAt. Эпоха времени (количество миллисекунд с 1 января 1970 года по UTC), в котором должна быть запланирована рассылка (необязательно).
schedule_desc string	Параметр запроса ScheduleDesc. Пользовательское описание (необязательно).
schedule_origin string	Параметр запроса ScheduleOrigin. Инициатор данного вызова (необязательно).
tagging_details dictionary	Подробности для маркировки или снятия метки изображения как «золотого»
device_image_family_name string	Имя семейства изображений устройства (например, коммутатор Cisco Catalyst 9300).
device_role string	Определяет роль устройства, допустимые значения включают ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION и CORE. ALL — эта роль обычно представляет все устройства в сети, независимо от их конкретных ролей или функций. UNKNOWN — эта роль назначается устройствам, роли или функции которых не определены или не классифицированы в Cisco Catalsyt Center. Это может произойти, если платформа не может определить роль устройства на основе имеющейся информации. ACCESS — эта роль обычно представляет коммутаторы или точки доступа, которые служат точками доступа для подключения устройств конечных пользователей к сети. Эти устройства часто расположены на краю сети и обеспечивают подключение к устройствам конечных пользователей. BORDER ROUTER — это устройства, которые соединяют различные домены или сегменты сети. Они часто служат шлюзами между различными сетями, такими как подключение корпоративной сети к интернету или подключение нескольких филиалов. DISTRIBUTION — эта роль представляет функции в качестве коммутаторов или маршрутизаторов распределения в иерархических сетевых конструкциях. Они агрегируют трафик от коммутаторов доступа и направляют его к ядру сети или к другим коммутаторам распределения. CORE — эта роль обычно представляет высокопроизводительные коммутаторы или маршрутизаторы, которые образуют основу сети. Они обрабатывают большие объёмы трафика и обеспечивают подключение между разными частями сети, такие как соединение коммутаторов распределения или межсетевые соединения.
image_name string	Имя изображения SWIM, которое будет помечено или снято с метки как «золотое».

site_name string	Имя сайта, для которого изображение 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	Указывает, включен ли отладка в SDK Cisco Catalyst Center. Варианты: `false` ← (по умолчанию) `true`
dnac_host string / обязательно	Имя хоста Cisco Catalyst 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. Если путь не указан - При True «dnac_log_append» генерируется «dnac.log» в текущем каталоге Ansible; журналы добавляются. При False «dnac_log_append» генерируется «dnac.log»; журналы перезаписываются. Если путь указан - При True «dnac_log_append» файл открывается в режиме добавления. При False «dnac_log_append» файл открывается в режиме записи (w). - В сценариях с общим файлом без режима добавления содержимое перезаписывается после каждого выполнения модуля. - Для общего файла журнала установите append в False для первого модуля (для перезаписи); для последующих модулей установите append в 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 Catalyst Center.
dnac_port string	Указывает номер порта, связанный с Cisco Catalyst Center. По умолчанию: `"443"`
dnac_task_poll_interval integer	Указывает интервал в секундах между последовательными вызовами API для получения подробностей о задаче. По умолчанию: `2`
dnac_username aliases: user string	Имя пользователя для аутентификации в Cisco Catalyst Center. По умолчанию: `"admin"`
dnac_verify boolean	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
dnac_version string	Указывает версию Cisco Catalyst Center, которую должен использовать SDK. По умолчанию: `"2.2.3.3"`

END_OF_DOCUMENT_MARKER

состояние строка	Состояние Catalyst Center после завершения модуля. Варианты: `"merged"` ← (по умолчанию)
validate_response_schema логическое	Флаг для Cisco Catalyst 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 Catalyst Center SDK
Параметры, начинающиеся с dnac_, используются Cisco Catalyst Center Python SDK для установления подключения

Примеры

- name: Import an image from a URL, tag it as golden and load it on device
  cisco.dnac.swim_workflow_manager:
    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_workflow_manager:
    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: Import bulk images from URL
  cisco.dnac.swim_workflow_manager:
    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"
                - "http://10.10.10.10/stda/cat9k_iosxe.17.12.02.SPA.bin"
            third_party: False

- name: Import images from CCO (cisco.com)
  cisco.dnac.swim_workflow_manager:
    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: CCO
        cco_image_details:
            image_name: cat9k_iosxe.17.06.06a.SPA.bin

- name: Tag the given image as golden and load it on device
  cisco.dnac.swim_workflow_manager:
    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_workflow_manager:
    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_workflow_manager:
    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_workflow_manager:
    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

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

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

Ключ	Описание
ответ словарь	Словарь с информацией об активации, возвращаемый 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"

Ключ

Описание

ответ

словарь

Словарь с информацией об активации, возвращаемый 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) Syed Khadeer Ahmed (@syed-khadeerahmed) Ajith Andrew J (@ajithandrewj)

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

© 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_workflow_manager_module.html