Spec-Zone.ru › Ansible

Модуль 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 enabled.

Политика MACsec должна быть определена в том же шаблоне политик фабрики.

auto_negotiation

string

Состояние автосогласования портов в группе политик интерфейса.

Значение по умолчанию — on.

Варианты:

  • "on"
  • "off"
  • "on_enforce"

cdp_admin_state

string

Административное состояние CDP включает протокол Cisco Discovery Protocol (CDP) на интерфейсе.

Значение по умолчанию — disabled.

Варианты:

  • "enabled"
  • "disabled"

controls

list / elements=string

Флаги управления порт-каналом группы политик интерфейса.

Значения по умолчанию: fast_sel_hot_stdby, graceful_conv, susp_individual.

Значение доступно только при значении interface_type port_channel.

Пустой список удалит controls из политики интерфейса.

При обновлении старые controls будут заменены новыми элементами.

Варианты:

  • "fast_sel_hot_stdby"
  • "graceful_conv"
  • "susp_individual"
  • "load_defer"
  • "symmetric_hash"

description

string

Описание группы политик интерфейса.

domains

list / elements=string

Домены, с которыми требуется связать эту политику интерфейса.

Домены должны быть определены в том же шаблоне политик фабрики.

При обновлении старые domains будут заменены новыми элементами.

Пустой список удалит domains из политики интерфейса.

host

псевдонимы: hostname

string

IP-адрес или имя хоста узла ACI Multi Site Orchestrator.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды MSO_HOST.

interface_type

string

Тип группы политик интерфейса.

Этот параметр обязателен при создании или обновлении группы политик интерфейса.

Варианты:

  • "physical"
  • "port_channel"

l2_interface_qinq

string

Состояние QinQ портов в группе политик интерфейса, определяющее способ сопоставления тегированного двумя тегами трафика VLAN.

Значение по умолчанию — disabled.

Варианты:

  • "core_port"
  • "double_q_tag_port"
  • "edge_port"
  • "disabled"

l2_interface_reflective_relay

string

Включает или отключает ретрансляцию отраженного трафика (802.1Qbg) для пересылки трафика обратно к месту назначения или целевому узлу.

Термин Virtual Ethernet Port Aggregator (VEPA) также используется для описания функциональности 802.1Qbg.

Значение по умолчанию — disabled.

Варианты:

  • "enabled"
  • "disabled"

link_level_bring_up_delay

integer

Задержка настройки эквалайзера с обратной связью по решению (DFE) в миллисекундах при поднятии порта.

Значение по умолчанию — 0.

Значение должно быть целым числом от 0 до 10000.

link_level_debounce_interval

integer

Интервал подавления дребезга состояния канала в миллисекундах.

Значение по умолчанию — 100.

Значение должно быть целым числом от 0 до 5000.

link_level_fec

string

Тип коррекции ошибок при передаче (FEC), используемый портами в группе политик интерфейса.

Значение по умолчанию — inherit.

Варианты:

  • "inherit"
  • "cl74_fc_fec"
  • "cl91_rs_fec"
  • "cons16_rs_fec"
  • "ieee_rs_fec"
  • "kp_fec"
  • "disable_fec"

lldp

dictionary

Конфигурация протокола обнаружения канального уровня (LLDP) для группы политик интерфейса.

receive_state

string

Состояние приема позволяет интерфейсу принимать пакеты LLDP.

Значение по умолчанию — enabled.

Варианты:

  • "enabled"
  • "disabled"

status

string

Состояние LLDP на интерфейсе.

Значение по умолчанию — enabled.

Варианты:

  • "enabled"
  • "disabled"

transmit_state

string

Состояние передачи позволяет отправлять пакеты LLDP с интерфейса.

Значение по умолчанию — enabled.

Варианты:

  • "enabled"
  • "disabled"

llfc_receive_state

string

Состояние приема LLFC позволяет интерфейсу принимать пакеты LLFC.

Значение по умолчанию — disabled.

Варианты:

  • "enabled"
  • "disabled"

llfc_transmit_state

string

Состояние передачи LLFC позволяет отправлять с интерфейса пакеты управления потоком на уровне канала (LLFC).

Значение по умолчанию — disabled.

Варианты:

  • "enabled"
  • "disabled"

load_balance_hashing

string

Информация из заголовка IP, используемая алгоритмом хеширования балансировки нагрузки порт-канала группы политик интерфейса.

Значение доступно только при значении interface_type port_channel.

Варианты:

  • "destination_ip"
  • "layer_4_destination_ip"
  • "layer_4_source_ip"
  • "source_ip"

login_domain

string

Имя домена входа, используемого для аутентификации.

Значение по умолчанию — Local.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды MSO_LOGIN_DOMAIN.

При использовании подключаемого модуля подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации ansible_httpapi_login_domain.

max_links

integer

Максимальное количество каналов в порт-канале группы политик интерфейса.

Значение по умолчанию — 16.

Значение должно находиться в диапазоне от 1 до 64.

Значение доступно только при значении interface_type port_channel.

mcp

dictionary

Параметры протокола MisCabling Protocol (MCP).

admin_state

string

Административное состояние MCP включает протокол MisCabling Protocol (MCP) на интерфейсе.

Значение по умолчанию — enabled.

Варианты:

  • "enabled"
  • "disabled"

grace_period_msec

integer

Период ожидания MCP в миллисекундах.

Значение по умолчанию — 0.

Значение должно находиться в диапазоне от 0 до 999.

Значение доступно только при значении MCP strict_mode on.

grace_period_sec

integer

Период ожидания MCP в секундах.

Значение по умолчанию — 3.

Значение должно находиться в диапазоне от 0 до 300.

Значение доступно только при значении MCP strict_mode on.

initial_delay_time

integer

Начальная задержка MCP в секундах.

Значение по умолчанию — 180.

Значение должно находиться в диапазоне от 0 до 1800.

Значение доступно только при значении MCP strict_mode on.

strict_mode

псевдонимы: mcp_mode

string

Строгий режим MCP.

Значение доступно только при значении MCP admin_state enabled.

Значение по умолчанию — off.

Варианты:

  • "on"
  • "off"

transmission_frequency_msec

integer

Период передачи MCP в миллисекундах.

Значение по умолчанию — 0.

Значение должно находиться в диапазоне от 0 до 999.

Значение доступно только при значении MCP strict_mode on.

transmission_frequency_sec

integer

Период передачи MCP в секундах.

Значение по умолчанию — 2.

Значение должно находиться в диапазоне от 0 до 300.

Значение доступно только при значении MCP strict_mode on.

min_links

integer

Минимальное количество активных каналов в порт-канале группы политик интерфейса.

Значение по умолчанию — 1.

Значение должно находиться в диапазоне от 1 до 16.

Значение доступно только при значении interface_type port_channel.

name

псевдонимы: interface_policy_group, interface_setting

string

Имя группы политик интерфейса.

output_level

string

Настраивает вывод этого модуля MSO.

normal означает стандартный вывод, включая словарь current

info добавляет информационный вывод, включая previous, proposed и словари sent

debug добавляет отладочный вывод, включая сведения filter_string, method, response, status и url

Если значение не указано в задаче, вместо него будет использовано значение переменной среды MSO_OUTPUT_LEVEL.

Варианты:

  • "debug"
  • "info"
  • "normal" ← (по умолчанию)

password

string

Пароль для аутентификации.

Если значение не указано в задаче, вместо него будет использовано значение одной из переменных среды MSO_PASSWORD или ANSIBLE_NET_PASSWORD.

pfc_admin_state

string

Административное состояние управления потоком с приоритетом (PFC).

Значение по умолчанию — auto.

Варианты:

  • "on"
  • "off"
  • "auto"

port

integer

Номер порта для REST-подключения.

Значение по умолчанию зависит от параметра `use_ssl`.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды MSO_PORT.

port_channel_mode

string

Режим порт-канала группы политик интерфейса.

Значение по умолчанию — static_channel_mode_on.

Значение доступно только при значении interface_type port_channel.

Варианты:

  • "static_channel_mode_on"
  • "lacp_passive"
  • "lacp_active"
  • "mac_pinning"
  • "mac_pinning_physical_nic_load"
  • "use_explicit_failover_order"

speed

string

Скорость портов, связанных с группой политик интерфейса.

Значение по умолчанию — inherit.

Варианты:

  • "100M"
  • "1G"
  • "10G"
  • "25G"
  • "40G"
  • "50G"
  • "100G"
  • "200G"
  • "400G"
  • "inherit"

state

string

Используйте absent для удаления.

Используйте query для просмотра одного или нескольких объектов.

Используйте present для создания или обновления.

Варианты:

  • "absent"
  • "query" ← (по умолчанию)
  • "present"

stp_bpdu_filter

string

Включение фильтра блоков данных протокола моста (BPDU) предотвращает передачу любых BPDU на портах

группы политик интерфейса путем фильтрации BPDU.

Отключение фильтра BPDU позволяет принимать BPDU на порту.

Значение по умолчанию — disabled.

Варианты:

  • "enabled"
  • "disabled"

stp_bpdu_guard

string

Включение защиты STP BPDU отключает порты, переводя их в режим «error-disable» при получении BPDU.

Отключение защиты STP BPDU позволяет принимать BPDU на порту.

Значение по умолчанию — disabled.

Варианты:

  • "enabled"
  • "disabled"

synce

string

Политика syncE, назначенная группе политик интерфейса.

Политика syncE должна быть определена в том же шаблоне политик фабрики.

template

string / обязательный

Имя шаблона.

Шаблон должен быть шаблоном политик фабрики.

timeout

integer

Тайм-аут на уровне сокета в секундах.

Значение по умолчанию — 30 секунд.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды MSO_TIMEOUT.

use_proxy

boolean

При значении false прокси не используется, даже если он задан в переменной среды на целевых узлах.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды MSO_USE_PROXY.

Значение по умолчанию — true.

Варианты:

  • false
  • true

use_ssl

логическое значение

Если false, вместо HTTPS-подключения, используемого по умолчанию, будет использоваться HTTP-подключение.

Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения MSO_USE_SSL.

При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации ansible_httpapi_use_ssl.

По умолчанию используется false при использовании плагина подключения HTTPAPI (mso или nd) и true при использовании устаревшего метода подключения (только для mso).

Варианты:

  • false
  • true

username

строка

Имя пользователя для аутентификации.

Если значение не указано в задаче, вместо него будут использоваться значения переменных окружения MSO_USERNAME или ANSIBLE_NET_USERNAME.

uuid

псевдонимы: interface_policy_group_uuid, interface_setting_uuid

строка

UUID группы политик интерфейса.

Этот параметр обязателен, если необходимо обновить атрибут name.

validate_certs

логическое значение

Если false, сертификаты SSL не будут проверяться.

Задавайте значение false только при использовании на сайтах, находящихся под вашим контролем и использующих самоподписанные сертификаты.

Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения MSO_VALIDATE_CERTS.

По умолчанию используется true.

Варианты:

  • false
  • true

vlan_scope

строка

Область действия инкапсуляции VLAN портов в группе политик интерфейса.

Значение по умолчанию — global.

Варианты:

  • "global"
  • "port_local"

Примечания

Примечание

  • Перед использованием этого модуля в плейбуке должен существовать 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

Авторы

  • Anvitha Jain (@anvjain)

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

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

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