Spec-Zone.ru › Ansible

Модуль cisco.mso.ndo_l3out_secondary_ip — управление вторичным IP-адресом 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_secondary_ip.

Новое в cisco.mso 2.12.0

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

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

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

Требования

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

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

Параметры

Параметр

Комментарии

dhcp_relay

boolean

Включить ли ретрансляцию протокола динамической настройки узла (DHCP).

Если параметр не задан, NDO по умолчанию использует dhcp_relay=false.

Варианты:

  • false
  • true

domain

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

string

Имя домена.

domain_provider

string

Поставщик домена.

Варианты:

  • "cloudfoundry"
  • "kubernetes"
  • "microsoft"
  • "openshift"
  • "openstack"
  • "redhat"
  • "vmware"
  • "nutanix"

domain_type

string

Тип домена.

Варианты:

  • "vmm"
  • "physical"

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.

ipv6_dad

string

Включить ли обнаружение дублирующихся IPv6-адресов (DAD).

Если параметр не задан и parent_type=floating_svi_path_attributes, NDO по умолчанию использует ipv6_dad=disabled.

Если параметр не задан, для всех остальных типов родительских объектов NDO по умолчанию использует ipv6_dad=enabled.

Варианты:

  • "enabled"
  • "disabled"

l3out

string

Имя L3Out.

Необходимо указать этот параметр или l3out_uuid.

l3out_uuid

string

UUID L3Out.

Необходимо указать этот параметр или l3out.

login_domain

string

Имя домена входа, используемого для аутентификации.

По умолчанию используется значение Local.

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

При использовании плагина подключения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря ansible_httpapi_login_domain.

nd_ra_prefix

boolean

Включить ли объявления маршрутизатора (RA) протокола обнаружения соседей (ND).

Если параметр не задан, NDO по умолчанию использует nd_ra_prefix=false.

Варианты:

  • false
  • true

node_id

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

string

Идентификатор узла (пограничного leaf-коммутатора).

output_level

string

Определяет формат вывода этого модуля MSO.

normal — стандартный вывод, включая словарь current

info добавляет информационный вывод, включая previous, proposed и словари sent

debug добавляет отладочный вывод, включая информацию filter_string, method, response, status и url

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

Варианты:

  • "debug"
  • "info"
  • "normal" ← (по умолчанию)

parent_type

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

Тип родительского объекта L3Out.

Варианты:

  • "floating_svi"
  • "routed"
  • "routed_sub"
  • "svi"
  • "floating_svi_path_attributes"

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.

secondary_address

псевдонимы: ipv4, ipv6, ip

string

Вторичный IP-адрес.

state

string

Для удаления используйте absent.

Для получения списка одного или нескольких объектов используйте query.

Для создания или обновления используйте present.

Варианты:

  • "absent"
  • "query" ← (по умолчанию)
  • "present"

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_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

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

dictionary

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

reference

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

boolean

Является ли сторона интерфейса виртуального агрегированного канала стороной B.

Варианты:

  • false ← (по умолчанию)
  • true

uuid

string

UUID виртуального агрегированного канала.

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

Примечания

Примечание

  • Перед использованием этого модуля в плейбуке необходимо создать template. Для создания шаблона L3Out используйте cisco.mso.ndo_template.
  • Перед использованием этого модуля в плейбуке необходимо создать l3out. Для создания L3Out используйте cisco.mso.ndo_l3out_template.
  • Перед использованием этого модуля в плейбуке необходимо создать родительский объект, определённый параметром parent_type. Для создания маршрутизируемого интерфейса L3Out используйте cisco.mso.ndo_l3out_routed_interface. Для создания маршрутизируемого субинтерфейса L3Out используйте cisco.mso.ndo_l3out_routed_sub_interface. Для создания интерфейса SVI L3Out используйте cisco.mso.ndo_l3out_svi_interface. Для создания плавающего интерфейса SVI L3Out используйте cisco.mso.ndo_l3out_floating_svi_interface. Для создания атрибутов пути плавающего интерфейса SVI L3Out используйте cisco.mso.ndo_l3out_floating_svi_interface_path_attributes.
  • Этот модуль создан для поддержки 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_routed_interface

Управление маршрутизируемыми интерфейсами L3Out в Cisco Nexus Dashboard Orchestrator (NDO).

cisco.mso.ndo_l3out_routed_sub_interface

Управление маршрутизируемыми субинтерфейсами L3Out в Cisco Nexus Dashboard Orchestrator (NDO).

cisco.mso.ndo_l3out_svi_interface

Управление интерфейсами SVI L3Out в Cisco Nexus Dashboard Orchestrator (NDO).

cisco.mso.ndo_l3out_floating_svi_interface

Управление плавающими интерфейсами SVI L3Out в Cisco Nexus Dashboard Orchestrator (NDO).

cisco.mso.ndo_l3out_floating_svi_interface_path_attributes

Управление атрибутами пути плавающих интерфейсов SVI L3Out в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a secondary address on a L3out Routed Interface of type port
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    path: eth1/3
    parent_type: routed
    secondary_address: 3::102/16
    state: present

- name: Create a secondary address on a L3out Routed Interface of type port channel
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    port_channel:
      uuid: '{{ port_channel_interface_3.current.uuid }}'
    parent_type: routed
    secondary_address: 10.2.0.2/24
    state: present

- name: Create a secondary address on a L3out SVI Interface of type port
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    path: eth1/1
    encapsulation_type: vlan
    encapsulation_value: 103
    parent_type: svi
    secondary_address: 10.0.0.2/24
    state: present

- name: Create a secondary address on a L3out SVI Interface of type port channel
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    port_channel:
      uuid: '{{ port_channel_interface_1.current.uuid }}'
    encapsulation_type: vxlan
    encapsulation_value: 50001
    parent_type: svi
    secondary_address: 1::102/16
    state: present

- name: Create a secondary address on a L3out SVI Interface of type virtual port channel side a
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    virtual_port_channel:
      uuid: '{{ virtual_port_channel_interface_1.current.uuid }}'
    encapsulation_type: vlan
    encapsulation_value: 1000
    parent_type: svi
    secondary_address: 10.0.2.3/24
    state: present

- name: Create a secondary address on a L3out SVI Interface of type virtual port channel side b
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    virtual_port_channel:
      uuid: '{{ virtual_port_channel_interface_1.current.uuid }}'
      side_b: true
    encapsulation_type: vlan
    encapsulation_value: 1000
    parent_type: svi
    secondary_address: 10.0.2.4/24
    state: present

- name: Create a secondary address on a L3out Routed Sub-Interface of type port
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    path: eth1/2
    encapsulation_type: vlan
    encapsulation_value: 101
    parent_type: routed_sub
    secondary_address: 10.1.0.2/24
    state: present

- name: Create a secondary address on a L3out Routed Sub-Interface of type port channel
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    port_channel:
      uuid: '{{ port_channel_interface_2.current.uuid }}'
    encapsulation_type: vlan
    encapsulation_value: 101
    parent_type: routed_sub
    secondary_address: 2::102/16
    state: present

- name: Create a secondary address on a L3Out Floating SVI Interface
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    encapsulation_type: vlan
    encapsulation_value: 100
    parent_type: floating_svi
    secondary_address: 10.4.0.3/24
    state: present

- name: Create a secondary address on a L3Out Floating SVI Interface path attributes
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    encapsulation_type: vlan
    encapsulation_value: 100
    domain_type: vmm
    domain_provider: vmware
    domain: ansible_test_vmm
    parent_type: floating_svi_path_attributes
    secondary_address: 10.4.0.4/24
    state: present

- name: Update a secondary address on a L3out Routed Interface of type port
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    path: eth1/3
    parent_type: routed
    secondary_address: 3::102/16
    dhcp_relay: true
    ipv6_dad: disabled
    nd_ra_prefix: true

- name: Get a secondary address on a L3out Routed Interface of type port
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    path: eth1/3
    parent_type: routed
    secondary_address: 3::102/16
    state: query
  register: query_secondary_address

- name: Get all secondary addresses on a L3out Routed Interface of type port
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    path: eth1/3
    parent_type: routed
    state: query
  register: query_all

- name: Delete a secondary address on a L3out Routed Interface of type port
  cisco.mso.ndo_l3out_secondary_ip:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: l3out_template
    l3out: l3out_1
    node_id: 101
    path: eth1/3
    parent_type: routed
    secondary_address: 3::102/16
    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_secondary_ip_module.html

Spec-Zone.ru

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