Модуль cisco.mso.ndo_virtual_port_channel_interface — управление интерфейсами виртуальных каналов портов в 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_virtual_port_channel_interface.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
description string	Описание интерфейса виртуального канала портов.
host aliases: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не задано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
interface_descriptions list / elements=dictionary	Список описаний интерфейсов интерфейса виртуального канала портов. Передача нового списка `interface_descriptions` полностью заменит существующий список для интерфейса виртуального канала портов. Передача пустого списка удалит `interface_descriptions=[]` из интерфейса виртуального канала портов.
description string	Описание интерфейса или группы интерфейсов.
interface_id string / обязательный	Идентификатор интерфейса или диапазон идентификаторов интерфейсов. При использовании диапазона идентификаторов интерфейсов для каждого идентификатора диапазона будет применено одинаковое значение `interface_descriptions.description`.
node string / обязательный	Идентификатор узла.
interface_policy_group aliases: policy, interface_policy, interface_setting dictionary	Группа политик интерфейса канала портов. Этот параметр можно использовать вместо `interface_policy_group_uuid`.
name string / обязательный	Имя группы политик интерфейса.
template string / обязательный	Имя шаблона, в котором создана группа политик интерфейса.
interface_policy_group_uuid aliases: policy_uuid, interface_policy_uuid, interface_setting_uuid string	UUID группы политик интерфейса канала портов. Этот параметр обязателен при создании интерфейса виртуального канала портов.
interfaces_node_1 aliases: interfaces_1, members_1 list / elements=string	Список используемых идентификаторов интерфейсов для первого узла. Можно использовать диапазоны идентификаторов интерфейсов. Этот параметр обязателен при создании интерфейса виртуального канала портов.
interfaces_node_2 aliases: interfaces_2, members_2 list / elements=string	Список используемых идентификаторов интерфейсов для второго узла. Можно использовать диапазоны идентификаторов интерфейсов. Этот параметр обязателен при создании интерфейса виртуального канала портов. Если `interfaces_node_2=[mirror]` и `interfaces_node_1` заданы явно, интерфейсы `interfaces_node_1` будут зеркально скопированы в `interfaces_node_2`.
login_domain string	Имя домена входа для аутентификации. Значение по умолчанию — Local. Если значение не задано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
name aliases: virtual_port_channel_interface, virtual_port_channel, vpc string	Имя интерфейса виртуального канала портов.
node_1 string	Идентификатор первого узла.
node_2 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`.
port integer	Номер порта для REST-соединения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не задано в задаче, вместо него будет использоваться значение переменной среды `MSO_PORT`.
state string	Используйте `absent` для удаления. Используйте `query` для просмотра одного или нескольких объектов. Используйте `present` для создания или обновления. Допустимые значения: `"absent"` `"query"` ← (по умолчанию) `"present"`
template aliases: fabric_resource_template string	Имя шаблона ресурсов фабрики. Этот параметр или `template_id` является обязательным.
template_id aliases: fabric_resource_template_id string	Идентификатор шаблона политик фабрики. Этот параметр или `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`. При использовании подключаемого модуля соединения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода соединения (только для mso) — `true`. Допустимые значения: `false` `true`
username string	Имя пользователя для аутентификации. Если значение не задано в задаче, вместо него будет использоваться значение переменных среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid aliases: virtual_port_channel_interface_uuid, virtual_port_channel_uuid, vpc_uuid string	UUID интерфейса виртуального канала портов. При обновлении существующего интерфейса виртуального канала портов этот параметр можно использовать вместо `virtual_port_channel_interface`. Этот параметр обязателен при обновлении параметра `name`.
validate_certs boolean	Если значение равно `false`, SSL-сертификаты проверяться не будут. Задавайте значение `false` только для сайтов под личным контролем, использующих самоподписанные сертификаты. Если значение не задано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Допустимые значения: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в плейбуке должен существовать template. Используйте cisco.mso.ndo_template для создания шаблона ресурсов фабрики.
Перед использованием этого модуля в плейбуке должен существовать interface_policy_group. Используйте cisco.mso.ndo_interface_setting для создания группы политик интерфейса типа «Канал портов».
Этот модуль разработан для поддержки Multi Site Orchestrator v2.1 или новее. Некоторые функции или все функции могут не работать в более ранних версиях.

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).
cisco.mso.ndo_interface_setting: Управление группами политик интерфейса в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a new Virtual Port Channel Interface
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    description: My Ansible Port Channel
    name: ansible_virtual_port_channel_interface
    node_1: 101
    node_2: 102
    interfaces_node_1:
      - 1/1
      - 1/10-11
    interfaces_node_2:
      - 1/2
    interface_policy_group:
      name: ansible_policy_group
      template: ansible_fabric_policy_template
    interface_descriptions:
      - node: 101
        interface_id: 1/1
        description: My single Ansible Interface for first node
      - node: 101
        interface_id: 1/10-11
        description: My group of Ansible Interface for first node
      - node: 102
        interface_id: 1/2
        description: My single Ansible Interface for second node
    state: present
  register: virtual_port_channel_interface_1

- name: Update a Virtual Port Channel Interface's interfaces and their descriptions
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    description: My Ansible Port Channel
    name: ansible_virtual_port_channel_interface
    node_1: 101
    node_2: 102
    interfaces_node_1:
      - 1/1
      - 1/5-7
    interfaces_node_2:
      - 1/1-2
    interface_descriptions:
      - node: 101
        interface_id: 1/1
        description: My single unchanged Ansible Interface for first node
      - node: 101
        interface_id: 1/5-7
        description: My new group of Ansible Interface for first node
      - node: 102
        interface_id: 1/1-2
        description: My new group of Ansible Interfaces for second node
    state: present

- name: Update a Virtual Port Channel Interface by mirroring node 1 and node 2 interfaces
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    description: My Ansible Port Channel
    name: ansible_virtual_port_channel_interface
    node_1: 101
    node_2: 102
    interfaces_node_1:
      - 1/1-9
      - 1/11-15
    interfaces_node_2: mirror
    state: present

- name: Update a Virtual Port Channel Interface's name with UUID
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    name: ansible_virtual_port_channel_interface_changed
    uuid: "{{ virtual_port_channel_interface_1.current.uuid }}"
    state: present

- name: Query a Virtual Port Channel Interface with name
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    name: ansible_virtual_port_channel_interface_changed
    state: query
  register: query_name

- name: Query a Virtual Port Channel Interface with UUID
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    uuid: "{{ virtual_port_channel_interface_1.current.uuid }}"
    state: query
  register: query_uuid

- name: Query all Virtual Port Channel Interfaces in a Fabric Resource Template
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    state: query
  register: query_all

- name: Delete a Virtual Port Channel Interface with name
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    name: ansible_virtual_port_channel_interface_changed
    state: absent

- name: Delete a Virtual Port Channel Interface with UUID
  cisco.mso.ndo_virtual_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    uuid: "{{ virtual_port_channel_interface_1.current.uuid }}"
    state: absent

Авторы

Gaspard Micol (@gmicol)

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

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