Spec-Zone.ru › Ansible

cisco.mso.ndo_l3out_routed_sub_interface module – Управление маршрутизируемыми подинтерфейсами 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_routed_sub_interface.

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

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

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

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

Требования

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

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

Параметры

Параметр

Комментарии

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-адрес или имя хоста узла ACI Multi Site Orchestrator.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды 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 уровня L2 фабрики.

Значение должно быть равно 1, находиться в диапазоне от 576 до 9216 или быть mtu=inherit.

node_group_policy

string

Имя политики группы узлов.

node_id

псевдонимы: node, border_leaf

string

Идентификатор узла (пограничного коммутатора leaf), на котором следует развернуть протокол маршрутизации L3Out и конфигурации протокола на уровне узла.

Этот параметр обязателен, если указан path.

Если конфигурация узла еще не существует, при указании параметра она создается в шаблоне L3Out.

Если конфигурация узла уже существует, при указании параметра она обновляется в шаблоне L3Out.

При указании параметра конфигурация узла удаляется из шаблона L3Out, если на нее не ссылаются интерфейсы.

node_loopback_ip

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

string

IP-адрес loopback узла.

node_router_id

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

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.

path

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

string

Путь к интерфейсу.

Путь должен вести к существующему физическому порту (например, eth1/1).

port

integer

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

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

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

port_channel

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

dictionary

Сведения о канале портов.

reference

псевдонимы: 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.

ptp

dictionary

Конфигурация протокола точного времени (PTP) для интерфейса.

Передача пустого словаря ptp={} удалит конфигурацию PTP с интерфейса.

mode

string

Режим PTP.

Если этот параметр не указан, NDO использует значение по умолчанию ptp.mode=multicast_dynamic.

Варианты:

  • "multicast_dynamic"
  • "multicast_master"
  • "unicast_master"

source_address

string

Исходный адрес PTP.

Если этот параметр не указан, NDO использует значение по умолчанию ptp.source_address=0.0.0.0.

unicast_destinations

list / элементы=string

IP-адреса одноадресных назначений PTP.

Старый ptp.unicast_destinations будет заменен новым ptp.unicast_destinations при обновлении.

IP-адреса одноадресных назначений PTP можно настроить только при условии ptp.mode=unicast_master.

user_profile

dictionary

Профиль пользователя PTP.

reference

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

dictionary

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

name

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

Имя профиля пользователя PTP.

template

string

Имя шаблона, содержащего профиль пользователя PTP.

Необходимо указать этот параметр или ptp.user_profile.reference.template_id.

template_id

string

Идентификатор шаблона, содержащего профиль пользователя PTP.

Необходимо указать этот параметр или ptp.user_profile.reference.template.

uuid

string

UUID профиля пользователя PTP.

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.
  • Перед использованием этого модуля в плейбуке должен существовать port_channel. Для этого можно использовать модуль cisco.mso.ndo_port_channel_interface.
  • Перед использованием этого модуля в плейбуке должен существовать ptp.user_profile. Для этого можно использовать модуль cisco.mso.ndo_ptp_policy_profiles.
  • Этот модуль создан для поддержки 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_ptp_policy_profiles

Управление профилями политики PTP в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a L3Out Routed Sub-Interface of type port
  cisco.mso.ndo_l3out_routed_sub_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    ipv4_address: 10.0.0.1/24
    ipv6_address: 2::101/16
    ipv6_link_local_address: FE80::10
    ipv6_dad: enabled
    mac: 00:22:BD:F8:19:FF
    mtu: inherit
    node_id: 101
    path: eth1/1
    encapsulation_type: vlan
    encapsulation_value: 100
    interface_group_policy: interface_group_policy_name
    node_router_id: 1.1.1.1
    node_group_policy: node_group_policy_name
    use_router_id_as_loopback: true
    ptp:
      user_profile:
        uuid: '{{ ptp_profile.current.uuid }}'
    state: present

- name: Create a L3Out Routed Sub-Interface of type port_channel with reference
  cisco.mso.ndo_l3out_routed_sub_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    ipv4_address: 10.1.0.1/24
    ipv6_address: 1::112/16
    ipv6_link_local_address: FE80::20
    ipv6_dad: disabled
    mac: 00:22:BD:F8:19:EE
    mtu: 2000
    port_channel:
      reference:
        name: port_channel_interface_name
        template: fabric_resource_template_name
    encapsulation_type: vlan
    encapsulation_value: 100
    interface_group_policy: interface_group_policy_name
    node_router_id: 2.2.2.2
    node_group_policy: node_group_policy_name
    use_router_id_as_loopback: false
    node_loopback_ip: 10.0.0.1
    ptp:
      mode: unicast_master
      user_profile:
        reference:
          name: ptp_profile_name
          template: fabric_policy_template_name
      source_address: 12.0.0.1
      unicast_destinations:
        - 12.0.0.2
        - 12.0.0.3
    state: present

- name: Update a L3Out Routed Sub-Interface of type port_channel with uuid
  cisco.mso.ndo_l3out_routed_sub_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template_id: "{{ l3out_template.current.templateId }}"
    l3out_uuid: "{{ l3out.current.uuid }}"
    ipv4_address: 10.1.0.1/24
    ipv6_address: 1::112/16
    ipv6_link_local_address: FE80::20
    ipv6_dad: disabled
    mac: 00:22:BD:F8:19:EE
    mtu: 2000
    port_channel:
      uuid: "{{ port_channel_interface.current.uuid }}"
    encapsulation_type: vlan
    encapsulation_value: 100
    interface_group_policy: interface_group_policy_name
    node_router_id: 2.2.2.2
    node_group_policy: node_group_policy_name
    use_router_id_as_loopback: false
    node_loopback_ip: 10.0.0.1
    state: present

- name: Remove PTP configuration from a L3Out Routed Sub-Interface of type port
  cisco.mso.ndo_l3out_routed_sub_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    path: eth1/1
    encapsulation_type: vlan
    encapsulation_value: 100
    ptp: {}
    state: present

- name: Query an existing L3Out Routed Sub-Interface of type port
  cisco.mso.ndo_l3out_routed_sub_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    path: eth1/1
    encapsulation_type: vlan
    encapsulation_value: 100
    state: query
  register: query_with_name

- name: Query an existing L3Out Routed Sub-Interface of type port_channel
  cisco.mso.ndo_l3out_routed_sub_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
    encapsulation_type: vlan
    encapsulation_value: 100
    state: query
  register: query_with_name

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

- name: Delete an existing L3Out Routed Sub-Interface
  cisco.mso.ndo_l3out_routed_sub_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    path: eth1/1
    encapsulation_type: vlan
    encapsulation_value: 100
    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_routed_sub_interface_module.html

Spec-Zone.ru

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