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

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

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

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

Управление интерфейсами L3Out SVI в 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 aliases: encap_mode string	Режим инкапсуляции интерфейса. Варианты: `"access"` `"trunk"` `"trunk_native"`
encapsulation_scope aliases: encap_scope string	Область действия инкапсуляции интерфейса. Варианты: `"local"` `"vrf"`
encapsulation_type aliases: encap_type string	Тип инкапсуляции интерфейса. Варианты: `"vlan"` `"vxlan"`
encapsulation_value aliases: encap, encapsulation, encapsulation_id integer	Значение инкапсуляции интерфейса. Параметр `encapsulation_type=vlan` задаёт VLAN ID, значение которого должно находиться в диапазоне 1–4094. Параметр `encapsulation_type=vxlan` задаёт VXLAN Network Identifier (VNI), значение которого должно находиться в диапазоне 5000–16777215.
host aliases: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
interface_group_policy string	Имя политики группы интерфейсов.
ipv4_address string	IPv4-адрес интерфейса. Для интерфейсов `virtual_port_channel` это IPv4-адрес стороны A.
ipv6_address string	IPv6-адрес интерфейса. Для интерфейсов `virtual_port_channel` это IPv6-адрес стороны A.
ipv6_dad string	Включать ли обнаружение дублирующихся IPv6-адресов (DAD). Если этот параметр не задан, NDO использует значение по умолчанию `ipv6_dad=enabled`. Для интерфейсов `virtual_port_channel` это состояние IPv6 DAD стороны A. Варианты: `"enabled"` `"disabled"`
ipv6_link_local_address string	Локальный IPv6-адрес канала интерфейса. Для интерфейсов `virtual_port_channel` это локальный IPv6-адрес канала стороны A.
l3out aliases: 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	Имя политики группы узлов. Для интерфейсов `virtual_port_channel` это политика группы узлов стороны A.
node_id aliases: node, border_leaf string	Идентификатор узла (коммутатора пограничного leaf), на котором следует развернуть протокол маршрутизации L3Out и конфигурации протоколов уровня узла. Этот параметр необходимо указать, если задано `path`. Этот параметр необходимо указать, если конфигурация узла отсутствует в шаблоне L3Out. Если параметр указан, конфигурация узла создаётся в шаблоне L3Out, если она ещё не существует. Если параметр указан, существующая конфигурация узла обновляется в шаблоне L3Out. Если параметр указан, конфигурация узла удаляется из шаблона L3Out, если на неё не ссылаются интерфейсы.
node_loopback_ip aliases: loopback_ip string	IP-адрес loopback узла. Для интерфейсов `virtual_port_channel` это IP-адрес loopback узла стороны A.
node_router_id aliases: router_id string	Идентификатор маршрутизатора узла. Этот параметр необходимо указать, если конфигурация узла отсутствует в шаблоне L3Out. Для интерфейсов `virtual_port_channel` это идентификатор маршрутизатора узла стороны A.
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`.
path aliases: interface string	Путь интерфейса. Путь должен указывать на существующий физический порт (например, eth1/1).
port integer	Номер порта, используемого для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_PORT`.
port_channel aliases: pc dictionary	Сведения о канале портов.
reference aliases: ref dictionary	Сведения о ссылке на канал портов. Необходимо указать этот параметр или `port_channel.uuid`.
name string / обязательный	Имя канала портов.
template string	Имя шаблона, содержащего канал портов. Необходимо указать этот параметр или `port_channel.reference.template_id`.
template_id string	Идентификатор шаблона, содержащего канал портов. Необходимо указать этот параметр или `port_channel.reference.template`.
uuid string	UUID канала портов. Необходимо указать этот параметр или `port_channel.reference`.
state string	Определяет требуемое состояние ресурса. Используйте `absent`, чтобы удалить ресурс. Используйте `query`, чтобы вывести список ресурсов. Используйте `present`, чтобы создать или обновить ресурс. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
target_dscp string	Целевое значение Differentiated Services Code Point (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 aliases: l3out_template string	Имя шаблона. Шаблон должен быть шаблоном L3Out. Необходимо указать этот параметр или `template_id`.
template_id aliases: 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 узла. Для интерфейсов `virtual_port_channel` это применяется к узлу стороны A. Варианты: `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`
virtual_port_channel aliases: vpc dictionary	Сведения о виртуальном канале портов.
reference aliases: ref dictionary	Сведения о ссылке на виртуальный канал портов. Необходимо указать этот параметр или `virtual_port_channel.uuid`.
name string / обязательный	Имя виртуального канала портов.
template string	Имя шаблона, содержащего виртуальный канал портов. Необходимо указать этот параметр или `virtual_port_channel.reference.template_id`.
template_id string	Идентификатор шаблона, содержащего виртуальный канал портов. Необходимо указать этот параметр или `virtual_port_channel.reference.template`.

side_b_ipv4_address string	IPv4-адрес интерфейса на стороне B.
side_b_ipv6_address string	IPv6-адрес интерфейса на стороне B.
side_b_ipv6_dad string	Включить ли обнаружение дублирующихся адресов IPv6 (DAD) на интерфейсе стороны B. Если этот параметр не указан, по умолчанию NDO использует `ipv6_dad=enabled`. Варианты: `"enabled"` `"disabled"`
side_b_ipv6_link_local_address string	Локальный IPv6-адрес интерфейса на стороне B.
side_b_node_group_policy string	Имя политики группы узлов стороны B.
side_b_node_loopback_ip псевдонимы: loopback_ip string	IP-адрес loopback узла стороны B.
side_b_node_router_id псевдонимы: router_id string	Идентификатор маршрутизатора узла стороны B. Этот параметр обязателен, если конфигурация узла не существует в шаблоне L3Out.
side_b_use_router_id_as_loopback boolean	Использовать ли идентификатор маршрутизатора в качестве адреса loopback узла стороны B. Варианты: `false` `true`
uuid string	UUID виртуального канала портов. Необходимо указать этот параметр или `virtual_port_channel.reference`.

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать 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.
Перед использованием этого модуля в плейбуке должен существовать port_channel. Для этого можно использовать модуль cisco.mso.ndo_port_channel_interface.
Перед использованием этого модуля в плейбуке должен существовать virtual_port_channel. Для этого можно использовать модуль cisco.mso.ndo_virtual_port_channel_interface.
Этот модуль создан для поддержки 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).
cisco.mso.ndo_port_channel_interface: Управление интерфейсами Port Channel в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_virtual_port_channel_interface: Управление интерфейсами Virtual Port Channel в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a L3Out SVI Interface of type port with L3Out Node configuration
  cisco.mso.ndo_l3out_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
    path: eth1/1
    ipv4_address: 10.0.0.2/24
    ipv6_address: 2::101/16
    ipv6_link_local_address: FE80::10
    ipv6_dad: disabled
    encapsulation_type: vxlan
    encapsulation_value: 5100
    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: Create a L3Out SVI Interface of type port_channel with uuid and L3Out Node configuration
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_router_id: 1.1.1.1
    port_channel:
      uuid: '{{ port_channel_interface_1.current.uuid }}'
    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_1
    node_group_policy: node_group_policy_1
    target_dscp: af41
    encapsulation_scope: local
    encapsulation_mode: access
    auto_state: enabled
    state: present

- name: Create a L3Out SVI Interface of type virtual_port_channel with reference and L3Out Node configuration
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_router_id: 1.1.1.1
    encapsulation_type: vxlan
    encapsulation_value: 51000
    ipv4_address: 10.0.2.4/24
    ipv6_address: 10::105/16
    ipv6_dad: disabled
    ipv6_link_local_address: FE80::14
    mac: 00:22:BD:F8:19:AD
    mtu: 9216
    virtual_port_channel:
      reference:
        name: ansible_virtual_port_channel_interface_1
        template: ansible_fabric_resource_template_template_1
      side_b_ipv4_address: 10.0.2.5/24
      side_b_ipv6_address: 10::106/16
      side_b_ipv6_link_local_address: FE80::15
      side_b_ipv6_dad: disabled
      side_b_node_router_id: 2.2.2.2
      side_b_node_group_policy: node_group_policy_1
    interface_group_policy: interface_group_policy_1
    node_group_policy: node_group_policy_1
    target_dscp: cs5
    encapsulation_scope: vrf
    encapsulation_mode: trunk_native
    auto_state: enabled
    state: present

- name: Update a L3Out SVI Interface of type port_channel with reference and L3Out Node configurations
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: "{{ l3out_template.current.templateId }}"
    l3out_uuid: "{{ l3out.current.uuid }}"
    node_router_id: 1.1.1.1
    port_channel:
      reference:
        name: ansible_port_channel_interface_1
        template_id: '{{ port_channel_interface_1.current.templateId }}'
    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_1
    target_dscp: af41
    encapsulation_scope: local
    encapsulation_mode: access
    auto_state: enabled
    state: present

- name: Query an existing L3Out SVI Interface of type port with L3Out Node configuration
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    path: eth1/1
    state: query
  register: query_with_name

- name: Query an existing L3Out SVI Interface of type port_channel with L3Out Node configuration
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    port_channel:
      reference:
        name: port_channel_interface_name
        template: fabric_resource_template_name
    state: query
  register: query_with_name

- name: Query an existing L3Out SVI Interface of type virtual port_channel with L3Out Node configurations
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    virtual_port_channel:
      uuid: '{{ virtual_port_channel_interface_1.current.uuid }}'
    state: query
  register: query_with_name

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

- name: Delete an existing L3Out SVI Interface of type port
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    path: eth1/1
    state: absent

- name: Delete an existing L3Out SVI Interface of type port_channel
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    port_channel:
      uuid: '{{ port_channel_interface_1.current.uuid }}'
    state: absent

- name: Delete an existing L3Out SVI Interface of type virtual_port_channel
  cisco.mso.ndo_l3out_svi_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    virtual_port_channel:
      reference:
        name: ansible_virtual_port_channel_interface_1
        template: ansible_fabric_resource_template_template_1
    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_svi_interface_module.html