Модуль cisco.mso.ndo_interface_setting — управление группами политик интерфейсов в Cisco Nexus Dashboard Orchestrator (NDO).
Примечание
Этот модуль входит в коллекцию cisco.mso (версия 2.13.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.mso. Для использования этого модуля могут потребоваться дополнительные компоненты. Подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: cisco.mso.ndo_interface_setting.
Краткое описание
- Управление группами политик интерфейсов в Cisco Nexus Dashboard Orchestrator (NDO).
- Этот модуль поддерживается только в ND v3.1 (NDO v4.3) и более поздних версиях.
Требования
На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.
- Multi Site Orchestrator версии 2.1 или новее
Параметры
Параметр | Комментарии |
|---|---|
access_macsec_policy string | Политика MACsec доступа. Значение доступно только при значении mcp_admin_state Политика MACsec должна быть определена в том же шаблоне политик фабрики. |
auto_negotiation string | Состояние автосогласования портов в группе политик интерфейса. Значение по умолчанию — Варианты:
|
cdp_admin_state string | Административное состояние CDP включает протокол Cisco Discovery Protocol (CDP) на интерфейсе. Значение по умолчанию — Варианты:
|
controls list / elements=string | Флаги управления порт-каналом группы политик интерфейса. Значения по умолчанию: Значение доступно только при значении interface_type Пустой список удалит При обновлении старые Варианты:
|
description string | Описание группы политик интерфейса. |
domains list / elements=string | |
host псевдонимы: hostname string | IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
interface_type string | Тип группы политик интерфейса. Этот параметр обязателен при создании или обновлении группы политик интерфейса. Варианты:
|
l2_interface_qinq string | Состояние QinQ портов в группе политик интерфейса, определяющее способ сопоставления тегированного двумя тегами трафика VLAN. Значение по умолчанию — Варианты:
|
l2_interface_reflective_relay string | Включает или отключает ретрансляцию отраженного трафика (802.1Qbg) для пересылки трафика обратно к месту назначения или целевому узлу. Термин Virtual Ethernet Port Aggregator (VEPA) также используется для описания функциональности 802.1Qbg. Значение по умолчанию — Варианты:
|
link_level_bring_up_delay integer | Задержка настройки эквалайзера с обратной связью по решению (DFE) в миллисекундах при поднятии порта. Значение по умолчанию — 0. Значение должно быть целым числом от 0 до 10000. |
link_level_debounce_interval integer | Интервал подавления дребезга состояния канала в миллисекундах. Значение по умолчанию — 100. Значение должно быть целым числом от 0 до 5000. |
link_level_fec string | Тип коррекции ошибок при передаче (FEC), используемый портами в группе политик интерфейса. Значение по умолчанию — Варианты:
|
lldp dictionary | Конфигурация протокола обнаружения канального уровня (LLDP) для группы политик интерфейса. |
|
receive_state string |
Состояние приема позволяет интерфейсу принимать пакеты LLDP. Значение по умолчанию — Варианты:
|
|
status string |
Состояние LLDP на интерфейсе. Значение по умолчанию — Варианты:
|
|
transmit_state string |
Состояние передачи позволяет отправлять пакеты LLDP с интерфейса. Значение по умолчанию — Варианты:
|
llfc_receive_state string | Состояние приема LLFC позволяет интерфейсу принимать пакеты LLFC. Значение по умолчанию — Варианты:
|
llfc_transmit_state string | Состояние передачи LLFC позволяет отправлять с интерфейса пакеты управления потоком на уровне канала (LLFC). Значение по умолчанию — Варианты:
|
load_balance_hashing string | Информация из заголовка IP, используемая алгоритмом хеширования балансировки нагрузки порт-канала группы политик интерфейса. Значение доступно только при значении interface_type Варианты:
|
login_domain string | Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды При использовании подключаемого модуля подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации |
max_links integer | Максимальное количество каналов в порт-канале группы политик интерфейса. Значение по умолчанию — 16. Значение должно находиться в диапазоне от 1 до 64. Значение доступно только при значении interface_type |
mcp dictionary | Параметры протокола MisCabling Protocol (MCP). |
|
admin_state string |
Административное состояние MCP включает протокол MisCabling Protocol (MCP) на интерфейсе. Значение по умолчанию — Варианты:
|
|
grace_period_msec integer |
Период ожидания MCP в миллисекундах. Значение по умолчанию — 0. Значение должно находиться в диапазоне от 0 до 999. Значение доступно только при значении MCP strict_mode |
|
grace_period_sec integer |
Период ожидания MCP в секундах. Значение по умолчанию — 3. Значение должно находиться в диапазоне от 0 до 300. Значение доступно только при значении MCP strict_mode |
|
initial_delay_time integer |
Начальная задержка MCP в секундах. Значение по умолчанию — 180. Значение должно находиться в диапазоне от 0 до 1800. Значение доступно только при значении MCP strict_mode |
|
strict_mode псевдонимы: mcp_mode string |
Строгий режим MCP. Значение доступно только при значении MCP admin_state Значение по умолчанию — Варианты:
|
|
transmission_frequency_msec integer |
Период передачи MCP в миллисекундах. Значение по умолчанию — 0. Значение должно находиться в диапазоне от 0 до 999. Значение доступно только при значении MCP strict_mode |
|
transmission_frequency_sec integer |
Период передачи MCP в секундах. Значение по умолчанию — 2. Значение должно находиться в диапазоне от 0 до 300. Значение доступно только при значении MCP strict_mode |
min_links integer | Минимальное количество активных каналов в порт-канале группы политик интерфейса. Значение по умолчанию — 1. Значение должно находиться в диапазоне от 1 до 16. Значение доступно только при значении interface_type |
name псевдонимы: interface_policy_group, interface_setting string | Имя группы политик интерфейса. |
output_level string | Настраивает вывод этого модуля MSO.
Если значение не указано в задаче, вместо него будет использовано значение переменной среды Варианты:
|
password string | Пароль для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение одной из переменных среды |
pfc_admin_state string | Административное состояние управления потоком с приоритетом (PFC). Значение по умолчанию — Варианты:
|
port integer | Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
port_channel_mode string | Режим порт-канала группы политик интерфейса. Значение по умолчанию — Значение доступно только при значении interface_type Варианты:
|
speed string | Скорость портов, связанных с группой политик интерфейса. Значение по умолчанию — Варианты:
|
state string | Используйте Используйте Используйте Варианты:
|
stp_bpdu_filter string | Включение фильтра блоков данных протокола моста (BPDU) предотвращает передачу любых BPDU на портах группы политик интерфейса путем фильтрации BPDU. Отключение фильтра BPDU позволяет принимать BPDU на порту. Значение по умолчанию — Варианты:
|
stp_bpdu_guard string | Включение защиты STP BPDU отключает порты, переводя их в режим «error-disable» при получении BPDU. Отключение защиты STP BPDU позволяет принимать BPDU на порту. Значение по умолчанию — Варианты:
|
synce string | Политика syncE, назначенная группе политик интерфейса. Политика syncE должна быть определена в том же шаблоне политик фабрики. |
template string / обязательный | Имя шаблона. Шаблон должен быть шаблоном политик фабрики. |
timeout integer | Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
use_proxy boolean | При значении Если значение не указано в задаче, вместо него будет использовано значение переменной среды Значение по умолчанию — Варианты:
|
use_ssl логическое значение | Если Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации По умолчанию используется Варианты:
|
username строка | Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будут использоваться значения переменных окружения |
uuid псевдонимы: interface_policy_group_uuid, interface_setting_uuid строка | UUID группы политик интерфейса. Этот параметр обязателен, если необходимо обновить атрибут |
validate_certs логическое значение | Если Задавайте значение Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения По умолчанию используется Варианты:
|
vlan_scope строка | Область действия инкапсуляции VLAN портов в группе политик интерфейса. Значение по умолчанию — Варианты:
|
Примечания
Примечание
- Перед использованием этого модуля в плейбуке должен существовать
template. Используйте cisco.mso.ndo_template, чтобы создать шаблон арендатора. - Перед использованием этого модуля в плейбуке должен существовать
access_macsec_policy. Используйте cisco.mso.ndo_macsec_policy, чтобы создать политику MACsec. - Перед использованием этого модуля в плейбуке должен существовать
domains. Используйте cisco.mso.ndo_physical_domain или cisco.mso.ndo_l3_domain, чтобы создать домен. - Перед использованием этого модуля в плейбуке должен существовать
synce. Используйте cisco.mso.ndo_synce_interface_policy, чтобы создать политику syncE. - Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.
См. также
См. также
- cisco.mso.ndo_template
-
Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
- cisco.mso.ndo_macsec_policy
-
Управление политиками MACsec в Cisco Nexus Dashboard Orchestrator (NDO).
Примеры
- name: Create an Interface policy group of interface_type physical
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
name: ansible_test_interface_policy_group_physical
description: "Interface Policy Group for Ansible Test"
interface_type: physical
state: present
- name: Create an Interface policy group of interface_type port_channel
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
name: ansible_test_interface_policy_group_port_channel
description: "Interface Policy Group for Ansible Test"
interface_type: port_channel
state: present
- name: Create an Interface policy group with all attributes
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
name: ansible_test_interface_policy_group_all
description: "Interface Policy Group for Ansible Test"
interface_type: port_channel
speed: 1G
auto_negotiation: on_enforce
vlan_scope: port_local
cdp_admin_state: enabled
port_channel_mode: lacp_active
min_links: 1
max_links: 16
controls: ["fast_sel_hot_stdby", "graceful_conv", "susp_individual"]
load_balance_hashing: destination_ip
synce: ansible_test_sync_e
link_level_debounce_interval: 100
link_level_bring_up_delay: 0
link_level_fec: ieee_rs_fec
l2_interface_qinq: edge_port
l2_interface_reflective_relay: enabled
lldp:
status: enabled
transmit_state: enabled
receive_state: enabled
domains:
- ansible_test_domain1
- ansible_test_domain2
stp_bpdu_filter: enabled
stp_bpdu_guard: enabled
llfc_transmit_state: enabled
llfc_receive_state: enabled
mcp:
admin_state: enabled
strict_mode: 'on'
initial_delay_time: 180
transmission_frequency_sec: 2
transmission_frequency_msec: 10
grace_period_sec: 3
grace_period_msec: 10
pfc_admin_state: 'on'
state: present
- name: Query all Interface policy groups
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
state: query
register: query_all
- name: Query a specific Interface policy group with name
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
name: ansible_test_interface_policy_group_physical
state: query
register: query_one_name
- name: Query a specific Interface policy group with UUID
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
uuid: "{{ query_one_name.current.uuid }}"
state: query
register: query_one_uuid
- name: Delete an Interface policy group with name
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
name: ansible_test_interface_policy_group_physical
state: absent
- name: Delete an Interface policy group with UUID
cisco.mso.ndo_interface_setting:
host: mso_host
username: admin
password: SomeSecretPassword
template: ansible_test_template
uuid: "{{ query_one_name.current.uuid }}"
state: absent
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/mso/ndo_interface_setting_module.html