модуль cisco.mso.ndo_l3out_floating_svi_interface — управление плавающими интерфейсами SVI L3Out в 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_l3out_floating_svi_interface.

Добавлено в cisco.mso 2.12.0

Краткое описание
Требования
Параметры
Примечания
См. также
Примеры

Краткое описание

Управление плавающими интерфейсами SVI L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
Этот модуль поддерживается только в ND v3.1 (NDO v4.3) и более поздних версиях.

Требования

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

Multi Site Orchestrator версии 2.1 или новее

Параметры

Параметр	Комментарии
auto_state string	Включать ли автоматическое состояние интерфейса. Определяет, будет ли интерфейс SVI активен или отключен в зависимости от состояния связанных с ним портов уровня 2. Варианты: `"enabled"` `"disabled"`
encapsulation_mode псевдонимы: encap_mode string	Режим инкапсуляции интерфейса. Варианты: `"access"` `"trunk"` `"trunk_native"`
encapsulation_scope псевдонимы: encap_scope string	Область действия инкапсуляции интерфейса. Варианты: `"local"` `"vrf"`
encapsulation_type псевдонимы: encap_type string	Тип инкапсуляции интерфейса. Варианты: `"vlan"` `"vxlan"`
encapsulation_value псевдонимы: encap, encapsulation, encapsulation_id integer	Значение инкапсуляции интерфейса. Параметр `encapsulation_type=vlan` задает идентификатор VLAN, который должен находиться в диапазоне 1–4094. Параметр `encapsulation_type=vxlan` задает идентификатор сети VXLAN (VNI), который должен находиться в диапазоне 5000–16777215.
host псевдонимы: hostname string	IP-адрес или имя хоста Multi Site Orchestrator ACI. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
interface_group_policy string	Имя политики группы интерфейсов.
ipv4_address string	IPv4-адрес интерфейса.
ipv6_address string	IPv6-адрес интерфейса.
ipv6_dad string	Включать ли обнаружение дублирующихся IPv6-адресов (DAD). Если этот параметр не задан, NDO использует значение по умолчанию `ipv6_dad=enabled`. Варианты: `"enabled"` `"disabled"`
ipv6_link_local_address string	Локальный IPv6-адрес канала интерфейса.
l3out псевдонимы: l3out_name string	Имя L3Out. Необходимо указать этот параметр или `l3out_uuid`.
l3out_uuid string	UUID L3Out. Необходимо указать этот параметр или `l3out`.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
mac string	MAC-адрес интерфейса.
mtu string	Максимальный размер блока передачи (MTU) интерфейса. Используйте `mtu=inherit`, чтобы наследовать значение, настроенное в параметрах MTU уровня 2 фабрики. Значение должно быть равно 1, находиться в диапазоне 576–9216 или быть `mtu=inherit`.
node_group_policy string	Имя политики группы узлов.
node_id псевдонимы: node, border_leaf string	Идентификатор узла (пограничного коммутатора leaf), на котором следует развернуть протокол маршрутизации L3Out и конфигурации протокола на уровне узла. Если параметр задан, конфигурация узла создается в шаблоне L3Out, если она еще не существует. Если параметр задан, конфигурация узла обновляется в шаблоне L3Out, если она уже существует. Если параметр задан и на конфигурацию узла не ссылаются интерфейсы, она удаляется из шаблона L3Out.
node_loopback_ip псевдонимы: loopback_ip string	IP-адрес loopback узла.
node_router_id псевдонимы: router_id string	Идентификатор маршрутизатора узла. Этот параметр обязателен, если конфигурация узла отсутствует в шаблоне L3Out.
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`.
port integer	Номер порта для REST-соединения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_PORT`.
state string	Определяет требуемое состояние ресурса. Используйте `absent`, чтобы удалить ресурс. Используйте `query`, чтобы вывести список ресурсов. Используйте `present`, чтобы создать или обновить ресурс. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
target_dscp string	Целевая кодовая точка дифференцированного обслуживания (DSCP) интерфейса. Если этот параметр не задан, NDO использует значение по умолчанию `target_dscp=unspecified`. Варианты: `"af11"` `"af12"` `"af13"` `"af21"` `"af22"` `"af23"` `"af31"` `"af32"` `"af33"` `"af41"` `"af42"` `"af43"` `"cs0"` `"cs1"` `"cs2"` `"cs3"` `"cs4"` `"cs5"` `"cs6"` `"cs7"` `"expedited_forwarding"` `"unspecified"` `"voice_admit"`
template псевдонимы: l3out_template string	Имя шаблона. Шаблон должен быть шаблоном L3Out. Необходимо указать этот параметр или `template_id`.
template_id псевдонимы: l3out_template_id string	Идентификатор шаблона L3Out. Необходимо указать этот параметр или `template`.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_TIMEOUT`.
use_proxy boolean	Если задано `false`, прокси использоваться не будет, даже если он определен в переменной среды на целевых хостах. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `false` `true`
use_router_id_as_loopback boolean	Использовать ли идентификатор маршрутизатора в качестве loopback-адреса узла. Варианты: `false` `true`
use_ssl boolean	Если задано `false`, вместо соединения HTTPS по умолчанию будет использоваться соединение HTTP. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USE_SSL`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_use_ssl`. По умолчанию используется `false` при работе с подключаемым модулем соединения HTTPAPI (mso или nd) и `true` при использовании устаревшего метода подключения (только для mso). Варианты: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs boolean	Если задано `false`, SSL-сертификаты не будут проверяться. Значение `false` следует задавать только на лично контролируемых сайтах, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template или template_id. Для этого можно использовать модуль cisco.mso.ndo_template.
Перед использованием этого модуля в плейбуке должен существовать l3out или l3out_uuid. Для этого можно использовать модуль cisco.mso.ndo_l3out_template.
Перед использованием этого модуля в плейбуке должен существовать node_group_policy. Для этого можно использовать модуль cisco.mso.ndo_l3out_node_group_policy.
Перед использованием этого модуля в плейбуке должен существовать interface_group_policy. Для этого можно использовать модуль cisco.mso.ndo_l3out_interface_group_policy.
Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.1 или новее. Некоторые функции или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3out_template: Управление L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3out_node_group_policy: Управление политикой группы узлов L3Out в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3out_interface_group_policy: Управление политикой группы интерфейсов L3Out в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a L3Out Floating SVI Interface with L3Out Node configuration
  cisco.mso.ndo_l3out_floating_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    node_router_id: 1.1.1.1
    ipv4_address: 10.0.0.2/24
    ipv6_address: 2::101/16
    ipv6_link_local_address: FE80::10
    ipv6_dad: disabled
    encapsulation_type: vlan
    encapsulation_value: 1200
    mac: 00:22:BD:F8:19:FE
    mtu: 1000
    interface_group_policy: interface_group_policy_1
    node_group_policy: node_group_policy_1
    target_dscp: af11
    encapsulation_scope: vrf
    encapsulation_mode: trunk
    auto_state: enabled
    state: present

- name: Update a L3Out Floating SVI Interface and L3Out Node configuration
  cisco.mso.ndo_l3out_floating_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: "{{ l3out_template.current.templateId }}"
    l3out_uuid: "{{ l3out.current.uuid }}"
    node_id: 101
    node_router_id: 1.1.1.1
    encapsulation_type: vlan
    encapsulation_value: 1200
    ipv4_address: 10.0.1.1/24
    ipv6_address: 1::102/16
    ipv6_dad: disabled
    ipv6_link_local_address: FE80::12
    mac: 00:22:BD:F8:19:CC
    mtu: 1800
    interface_group_policy: interface_group_policy_2
    node_group_policy: node_group_policy_2
    target_dscp: af41
    encapsulation_scope: local
    encapsulation_mode: access
    auto_state: enabled
    state: present

- name: Query an existing L3Out Floating SVI Interface with L3Out Node configuration
  cisco.mso.ndo_l3out_floating_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    encapsulation_type: vlan
    encapsulation_value: 1200
    state: query
  register: query_one

- name: Query all existing L3Out Floating SVI Interfaces of a L3Out with L3Out Node configuration
  cisco.mso.ndo_l3out_floating_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    state: query
  register: query_all

- name: Delete an existing L3Out Floating SVI Interface
  cisco.mso.ndo_l3out_floating_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    encapsulation_type: vlan
    encapsulation_value: 1200
    state: absent

Авторы

Akini Ross (@akinross)

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

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