модуль cisco.mso.ndo_port_channel_interface — управление интерфейсами Port Channel в 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_port_channel_interface.

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

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

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

Требования

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

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

Параметры

Параметр	Описание
description string	Описание интерфейса Port Channel.
host aliases: hostname string	IP-адрес или имя узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_HOST`.
interface_descriptions list / elements=dictionary	Список описаний интерфейсов интерфейса Port Channel. Передача нового списка `interface_descriptions` полностью заменит существующий список интерфейса Port Channel. Передача пустого списка удалит `interface_descriptions=[]` интерфейса Port Channel.
description string	Описание интерфейса или группы интерфейсов.
interface_id string / обязательный	Идентификатор интерфейса или диапазон идентификаторов интерфейсов. При использовании диапазона идентификаторов интерфейсов для каждого идентификатора в диапазоне будет применено одно и то же `interface_descriptions.description`.
interface_policy_group aliases: policy, interface_policy, interface_setting dictionary	Группа политик интерфейса Port Channel. Этот параметр можно использовать вместо `interface_policy_group_uuid`. Если используются оба параметра, `interface_policy_group` будет проигнорирован.
name string / обязательный	Имя группы политик интерфейса.
template string / обязательный	Имя шаблона, в котором создана группа политик интерфейса.
interface_policy_group_uuid aliases: policy_uuid, interface_policy_uuid, interface_setting_uuid string	UUID группы политик интерфейса Port Channel. Этот параметр требуется только при создании нового интерфейса Port Channel.
interfaces aliases: members list / elements=string	Список используемых идентификаторов интерфейсов. Можно использовать диапазоны идентификаторов интерфейсов. Этот параметр требуется только при создании нового интерфейса Port Channel.
login_domain string	Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
name aliases: port_channel_interface, port_channel string	Имя интерфейса Port Channel.
node string	Идентификатор узла. Этот параметр требуется только при создании нового интерфейса Port Channel.
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 string / обязательный	Имя шаблона. Шаблон должен быть шаблоном Fabric Resource.
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 aliases: port_channel_interface_uuid, port_channel_uuid string	UUID интерфейса Port Channel. При обновлении существующего интерфейса Port Channel этот параметр можно использовать вместо `port_channel_interface`. Этот параметр обязателен при обновлении параметра `port_channel_interface`.
validate_certs boolean	Если `false`, сертификаты SSL проверяться не будут. Устанавливайте значение `false` только на контролируемых вами сайтах, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Возможные значения: `false` `true`

Примечания

Примечание

Перед использованием этого модуля в сценарии должен существовать template. Для создания шаблона Fabric Resource используйте cisco.mso.ndo_template.
Перед использованием этого модуля в сценарии должен существовать interface_policy_group. Для создания группы политик интерфейса типа Port Channel используйте 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 Port Channel Interface
  cisco.mso.ndo_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    description: My Ansible Port Channel
    name: ansible_port_channel_interface
    node: 101
    interfaces:
      - 1/1
      - 1/10-11
    interface_policy_group:
      name: ansible_policy_group
      template: ansible_fabric_policy_template
    interface_descriptions:
      - interface_id: 1/1
        description: My single Ansible Interface
      - interface_id: 1/10-11
        description: My group of Ansible Interfaces
    state: present
  register: port_channel_interface_1

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

- name: Update a Port Channel Interface's interfaces and their descriptions
  cisco.mso.ndo_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    name: ansible_port_channel_interface_changed
    interfaces:
      - 1/1
      - 1/3
      - 1/5-7
    interface_descriptions:
      - interface_id: 1/1
        description: My single unchanged Ansible Interface
      - interface_id: 1/3
        description: My new single Ansible Interface
      - interface_id: 1/5-7
        description: My new group of Ansible Interfaces
    state: present

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

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

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

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

- name: Delete a Port Channel Interface with UUID
  cisco.mso.ndo_port_channel_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_fabric_resource_template
    uuid: "{{ 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_port_channel_interface_module.html