Модуль cisco.mso.ndo_l3out_template — управление 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_template.

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

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

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

Требования

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

Multi Site Orchestrator v2.1 или новее

Параметры

Параметр	Комментарии
attached_host_route_redistribution псевдонимы: attached_host_route string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой маршрутов перераспределения маршрута подключенного узла. Если указать пустую строку, из L3Out будет удален `attached_host_route_redistribution=""`.
bgp dictionary	Конфигурация протокола маршрутизации BGP для L3Out.
inbound_route_map псевдонимы: import_route, inbound_route string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой входящих маршрутов. Если указать пустую строку, из L3Out будет удален `bgp.inbound_route_map=""`.
outbound_route_map псевдонимы: export_route, outbound_route string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой исходящих маршрутов. Если указать пустую строку, из L3Out будет удален `bgp.outbound_route_map=""`.
route_dampening_ipv4 псевдонимы: dampening_ipv4 string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой маршрутов подавления колебаний маршрутов IPv4. Если указать пустую строку, из L3Out будет удален `bgp.route_dampening_ipv4=""`.
route_dampening_ipv6 псевдонимы: dampening_ipv6 string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой маршрутов подавления колебаний маршрутов IPv6. Если указать пустую строку, из L3Out будет удален `bgp.route_dampening_ipv6=""`.
state string	Используйте `enabled` для настройки протокола маршрутизации BGP. Используйте `disabled` для удаления протокола маршрутизации BGP. Варианты: `"enabled"` ← (по умолчанию) `"disabled"`
connected_route_redistribution псевдонимы: connected_route string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой маршрутов перераспределения подключенных маршрутов. Если указать пустую строку, из L3Out будет удален `connected_route_redistribution=""`.
description string	Описание L3Out. Если указать пустую строку, из L3Out будет удален `description=""`.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_HOST`.
interleak string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой маршрутов Interleak. Если указать пустую строку, из L3Out будет удален `interleak=""`.
l3_domain string	Имя домена L3.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`.
name string	Имя L3Out.
ospf dictionary	Конфигурация протокола маршрутизации OSPF для L3Out.
area_id string	Идентификатор области OSPF. Этот параметр обязателен, если `ospf.state=enabled`.
area_type string	Тип области OSPF. Этот параметр обязателен, если `ospf.state=enabled`. Варианты: `"regular"` `"stub"` `"nssa"`
cost integer	Стоимость области OSPF. Если при создании значение не задано, по умолчанию используется 1.
originate_default_route string	Параметр Originate Default Route в конфигурации L3Out позволяет фабрике ACI объявлять маршрут по умолчанию (0.0.0.0/0) внешним сетям. Если указать пустую строку, из L3Out будет удален `ospf.originate_default_route`. Варианты: `"only"` `"in_addition"` `""`
originate_default_route_always псевдонимы: always boolean	Включение этого параметра задает `ospf.originate_default_route=only`, если при создании не задан `ospf.originate_default_route`. Этот параметр применяется только в том случае, если для L3Out настроен OSPF. Варианты: `false` `true`
originate_summary_lsa псевдонимы: originate_lsa boolean	Этот параметр предназначен для областей OSPF NSSA (неполная тупиковая область) и Stub. Если этот параметр отключен, пограничный leaf не отправляет в область NSSA или Stub не только LSA типов 4 и 5, но и LSA типа 3. Вместо этого пограничный leaf создает и отправляет в область маршрут по умолчанию. Если в этой области изначально отсутствуют LSA типа 3, маршрут по умолчанию не создается. Варианты: `false` `true`
send_redistributed_lsas псевдонимы: redistributed_lsas boolean	Этот параметр предназначен для области OSPF NSSA (неполная тупиковая область). Если этот параметр отключен, пограничный leaf не отправляет перераспределенные маршруты в область NSSA. Обычно это используется, когда `ospf.originate_summary_lsa=false`. Так как отключение параметра `ospf.originate_summary_lsa` приводит к созданию и отправке маршрута по умолчанию в область NSSA или Stub. Варианты: `false` `true`
state string	Используйте `enabled` для настройки протокола маршрутизации OSPF. Используйте `disabled` для удаления протокола маршрутизации OSPF. Варианты: `"enabled"` ← (по умолчанию) `"disabled"`
suppress_forwarding_addr_translated_lsa псевдонимы: suppress_fa_lsa boolean	Этот параметр предназначен для области OSPF NSSA (неполная тупиковая область). Когда ABR OSPF NSSA (пограничный маршрутизатор области) преобразует LSA типа 7 в LSA типа 5 для отправки через области, не относящиеся к NSSA. Как правило, в качестве адреса пересылки включается IP-адрес исходного ASBR (пограничного маршрутизатора автономной системы). Однако, если у маршрутизатора OSPF, получившего LSA типа 5, отсутствует маршрут к этому адресу пересылки. Маршрут может не быть установлен в таблицу маршрутизации маршрутизатора. Включение этого параметра запрещает ABR добавлять адрес пересылки при преобразовании LSA типа 7 в тип 5, предотвращая возникновение этой проблемы. Варианты: `false` `true`
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`.
pim boolean	Флаг многоадресной рассылки, независимой от протокола (PIM), для L3Out. По умолчанию PIM отключен. Чтобы включить PIM, необходимо включить многоадресную рассылку уровня 3 на `vrf`. Варианты: `false` `true`
port integer	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_PORT`.
state string	Используйте `absent` для удаления. Используйте `query` для вывода одного или нескольких объектов. Используйте `present` для создания или обновления. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
static_route_redistribution псевдонимы: static_route string	Имя политики Route Map для управления маршрутами, которую необходимо связать с картой маршрутов перераспределения статических маршрутов. Если указать пустую строку, из L3Out будет удален `static_route_redistribution=""`.
target_dscp string	Уровень DSCP для L3Out. Варианты: `"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.
timeout integer	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_TIMEOUT`.
use_proxy boolean	Если `false`, прокси использоваться не будет, даже если он задан в переменной окружения на целевых узлах. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_USE_PROXY`. Значение по умолчанию — `true`. Варианты: `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`.
uuid string	UUID объекта L3Out. Этот параметр обязателен, если необходимо обновить L3Out `name`.
validate_certs boolean	Если `false`, SSL-сертификаты не будут проверяться. Значение `false` следует задавать только для подконтрольных вам сайтов, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`
vrf dictionary	VRF, связанная с L3Out.
name string / обязательный	Имя VRF.
schema string / обязательный	Имя схемы.
template string / обязательный	Имя шаблона.

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Используйте cisco.mso.ndo_template для создания шаблона L3Out.
Перед использованием этого модуля в плейбуке должен существовать vrf. Используйте cisco.mso.mso_schema_template_vrf для создания VRF.
Перед использованием этого модуля в плейбуке должен существовать l3_domain. Используйте cisco.mso.ndo_l3_domain для создания домена L3Out.
Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.mso_schema_template_vrf: Управление VRF в шаблонах схем.
cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_l3_domain: Управление доменами L3 в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a new L3Out object without BGP and OSPF
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    name: "l3out_1"
    vrf:
      name: "VRF1"
      schema: "Schema1"
      template: "Template1"
    state: "present"

- name: Query a L3Out object with name
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    name: "l3out_1"
    state: "query"
  register: query_l3out_name

- name: Update a L3Out object name with UUID
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    uuid: "{{ query_l3out_name.current.uuid }}"
    name: "l3out_1_updated"
    description: "updated description"
    state: "present"

- name: Create a new L3Out object with BGP and OSPF
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    name: "l3out_1_new"
    vrf:
      name: "VRF1"
      schema: "Schema1"
      template: "Template1"
    routing_protocols: ["bgp", "ospf"]
    bgp:
      inbound_route_map: "ans_route_map"
      outbound_route_map: "ans_route_map"
      route_dampening_ipv4: "ans_route_map"
      route_dampening_ipv6: "ans_route_map"
    ospf:
      area_id: "0.0.0.1"
      area_type: "regular"
      cost: 1
      send_redistributed_lsas: true
      originate_summary_lsa: true
      suppress_forwarding_addr_translated_lsa: true
      originate_default_route: "only"
      originate_default_route_always: false
    interleak: "ans_route_map"
    static_route_redistribution: "ans_route_map"
    connected_route_redistribution: "ans_route_map"
    attached_host_route_redistribution: "ans_route_map"
    state: "present"

- name: Update a L3Out object BGP and OSPF values
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    name: "l3out_1_new"
    vrf:
      name: "VRF1"
      schema: "Schema1"
      template: "Template1"
    routing_protocols: ["bgp", "ospf"]
    bgp:
      route_dampening_ipv4: "ans_route_map_2"
      route_dampening_ipv6: "ans_route_map_2"
    ospf:
      area_id: "0.0.0.2"
      area_type: "stub"
      cost: 3
      send_redistributed_lsas: true
      originate_summary_lsa: true
      suppress_forwarding_addr_translated_lsa: true
    interleak: "ans_route_map"
    static_route_redistribution: "ans_route_map"
    connected_route_redistribution: "ans_route_map"
    attached_host_route_redistribution: "ans_route_map"
    state: "present"

- name: Clear bgp and ospf routing protocol from the existing L3Out
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    name: "l3out_1_new"
    vrf:
      name: "VRF1"
      schema: "Schema1"
      template: "Template1"
    routing_protocol: ["bgp"]
    bgp:
      state: disabled
    ospf:
      state: disabled
    state: "present"

- name: Query a L3Out object with uuid
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    uuid: "{{ query_l3out_name.current.uuid }}"
    state: "query"
  register: query_l3out_name

- name: Query all L3Out objects
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    state: "query"
  register: query_all_l3out

- name: Delete a L3Out object with name
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    name: "l3out_1"
    state: "absent"

- name: Delete a L3Out object with uuid
  cisco.mso.ndo_l3out_template:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    l3out_template: l3out_template
    uuid: "{{ query_l3out_name.current.uuid }}"
    state: "absent"

Авторы

Sabari Jaganathan (@sajagana)

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

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