Spec-Zone.ru › Ansible

Модуль cisco.mso.ndo_l3out_routed_interface — управление маршрутизируемыми интерфейсами 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_interface.

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

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

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

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

Требования

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

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

Параметры

Параметр

Комментарии

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

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

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

Этот параметр обязателен, если конфигурация узла отсутствует в шаблоне 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.

path

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

string

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

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

port

integer

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

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

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

port_channel

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

dictionary

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

micro_bfd_address

string

Адрес для micro BFD.

micro_bfd_enabled

boolean

Включить ли micro BFD (обнаружение двунаправленной переадресации) на интерфейсе.

Варианты:

  • false
  • true

micro_bfd_start_timer

integer

Таймер запуска micro BFD.

Значение должно быть равно 0 или находиться в диапазоне 60–3600.

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.

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

Варианты:

  • 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 Interface of type port with L3Out Node configuration
  cisco.mso.ndo_l3out_routed_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
    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 Interface of type port_channel with reference and L3Out Node configuration
  cisco.mso.ndo_l3out_routed_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:
      micro_bfd_enabled: true
      micro_bfd_address: 1::110
      micro_bfd_start_timer: 60
      reference:
        name: port_channel_interface_name
        template: fabric_resource_template_name
    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 Interface of type port_channel with uuid and L3Out Node configuration
  cisco.mso.ndo_l3out_routed_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:
      micro_bfd_enabled: true
      micro_bfd_address: 1::110
      micro_bfd_start_timer: 60
      uuid: "{{ port_channel_interface.current.uuid }}"
    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 Interface of type port
  cisco.mso.ndo_l3out_routed_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    path: eth1/1
    ptp: {}
    state: present

- name: Query an existing L3Out Routed Interface of type port with L3Out Node configuration
  cisco.mso.ndo_l3out_routed_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 Routed Interface of type port_channel with L3Out Node configuration
  cisco.mso.ndo_l3out_routed_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 all existing Routed Interfaces of a L3Out with L3Out Node configuration
  cisco.mso.ndo_l3out_routed_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    state: query

- name: Delete an existing L3Out Routed Interface
  cisco.mso.ndo_l3out_routed_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_name
    node_id: 101
    path: eth1/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_routed_interface_module.html

Spec-Zone.ru

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