Модуль cisco.dnac.sda_fabric_devices – Модуль ресурсов для устройств Sda Fabricdevices

Примечание

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

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

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

Чтобы использовать его в playbook, укажите: cisco.dnac.sda_fabric_devices.

Новинка в cisco.dnac 6.14.0

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

Обзор

Управление операциями создания, обновления и удаления ресурса Sda Fabricdevices.
Добавление устройств fabric на основе пользовательского ввода.
Удаление устройства fabric по его ID.
Удаление устройств fabric на основе пользовательского ввода.
Обновление устройств fabric на основе пользовательского ввода.

Примечание

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

Требования

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

dnacentersdk >= 2.7.2
python >= 3.5

Параметры

Параметр	Комментарии
deviceRoles строка	Параметр запроса deviceRoles. Роли устройства в фабрике.
dnac_debug логическое	Флаг для Cisco DNA Center SDK, позволяющий включить отладку. Варианты: `false` ← (по умолчанию) `true`
dnac_host строка / обязательно	Имя хоста Cisco DNA Center.
dnac_password строка	Пароль Cisco DNA Center для аутентификации.
dnac_port целое число	Порт Cisco DNA Center. По умолчанию: `443`
dnac_username псевдонимы: user строка	Имя пользователя Cisco DNA Center для аутентификации. По умолчанию: `"admin"`
dnac_verify логическое	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
dnac_version строка	Указывает SDK, какую версию Cisco DNA Center использовать. По умолчанию: `"2.3.7.6"`
fabricId строка	Параметр запроса fabricId. Идентификатор фабрики, к которой принадлежит устройство.
id строка	Параметр пути id. Идентификатор устройства в фабрике.
networkDeviceId строка	Параметр запроса networkDeviceId. Идентификатор сетевого устройства в фабрике.
payload список / элементы=словарь	Полезная нагрузка для устройств SDA Fabric.
borderDeviceSettings словарь	borderDeviceSettings для устройств SDA Fabric.
borderTypes список / элементы=строка	Список типов границ устройства в фабрике. Допустимые значения: LAYER_2, LAYER_3.
layer3Settings словарь	layer3Settings для устройств SDA Fabric.
borderPriority целое число	Приоритет границы устройства в фабрике. Допустимый диапазон: 1-9. Меньшее значение означает более высокий приоритет. Например, приоритет 1 имеет приоритет над 5. По умолчанию приоритет устанавливается в 10.
importExternalRoutes логическое	Установите это значение для импорта внешних маршрутов из других протоколов маршрутизации (таких как BGP) в плоскость управления фабрикой. (обновление этого поля не разрешено). Варианты: `false` `true`
isDefaultExit логическое	Установите это значение, чтобы устройство границы фабрики было шлюзом по умолчанию для этого сайта. Любой неизвестный трафик будет отправлен на это устройство границы фабрики от узлов края. (обновление этого поля не разрешено). Варианты: `false` `true`
localAutonomousSystemNumber строка	Номер локальной автономной системы BGP устройства границы фабрики. Допустимый диапазон: 1 до 4294967295. (обновление этого поля не разрешено).
prependAutonomousSystemCount целое число	Количество автономных систем, добавляемых к префиксу устройства границы фабрики. Допустимый диапазон: 1 до 10.
deviceRoles список / элементы=строка	Список ролей устройства в фабрике. Допустимые значения: CONTROL_PLANE_NODE, EDGE_NODE, BORDER_NODE. (обновление этого поля не разрешено).

fabricId string	ID сайта/зоны сети этого устройства ткани. (обновление этого поля запрещено).
id string	ID устройства ткани. (обновление этого поля запрещено).
networkDeviceId string	Идентификатор сетевого устройства устройства ткани. (обновление этого поля запрещено).
validate_response_schema boolean	Флаг для Cisco DNA Center SDK для включения проверки заголовков запросов по отношению к JSON-схеме. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Используемые методы SDK: sda.Sda.add_fabric_devices, sda.Sda.delete_a_fabric_device_by_id, sda.Sda.update_fabric_devices,
Используемые пути: post /dna/intent/api/v1/sda/fabricDevices, delete /dna/intent/api/v1/sda/fabricDevices, delete /dna/intent/api/v1/sda/fabricDevices/{id}, put /dna/intent/api/v1/sda/fabricDevices,
Не поддерживает check_mode
Плагин выполняется на узле управления и не использует плагины подключения Ansible, а вместо этого использует встроенный менеджер подключений из Cisco DNAC SDK
Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления подключения

См. также

Документация Cisco DNA Center по SDA AddFabricDevices: Полное описание API AddFabricDevices.
Документация Cisco DNA Center по SDA DeleteAFabricDeviceById: Полное описание API DeleteAFabricDeviceById.
Документация Cisco DNA Center по SDA DeleteFabricDevices: Полное описание API DeleteFabricDevices.
Документация Cisco DNA Center по SDA UpdateFabricDevices: Полное описание API UpdateFabricDevices.

Примеры

- name: Update all
  cisco.dnac.sda_fabric_devices:
    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}}"
    state: present
    payload:
    - borderDeviceSettings:
        borderTypes:
        - string
        layer3Settings:
          borderPriority: 0
          importExternalRoutes: true
          isDefaultExit: true
          localAutonomousSystemNumber: string
          prependAutonomousSystemCount: 0
      deviceRoles:
      - string
      fabricId: string
      id: string
      networkDeviceId: string

- name: Delete all
  cisco.dnac.sda_fabric_devices:
    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}}"
    state: absent
    deviceRoles: string
    fabricId: string
    networkDeviceId: string

- name: Create
  cisco.dnac.sda_fabric_devices:
    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}}"
    state: present
    payload:
    - borderDeviceSettings:
        borderTypes:
        - string
        layer3Settings:
          borderPriority: 0
          importExternalRoutes: true
          isDefaultExit: true
          localAutonomousSystemNumber: string
          prependAutonomousSystemCount: 0
      deviceRoles:
      - string
      fabricId: string
      networkDeviceId: string

- name: Delete by id
  cisco.dnac.sda_fabric_devices:
    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}}"
    state: absent
    id: string

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

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

Ключ	Описание
dnac_response словарь	Словарь или список с ответом, возвращённым Cisco DNAC Python SDK Возвращается: всегда Пример: `{"response": {"taskId": "string", "url": "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/dnac/sda_fabric_devices_module.html