Модуль cisco.mso.ndo_physical_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_physical_interface.

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

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

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

Требования

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

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

Параметры

Параметр	Комментарии
breakout_mode string	Режим breakout позволяет разделить порт Ethernet на несколько портов с более низкой скоростью. Этот параметр доступен только при значении `physical_interface_type`, равном `breakout`. Значение по умолчанию: `4x10G`. Варианты: `"4x10G"` `"4x25G"` `"4x100G"`
description string	Описание физического интерфейса.
host псевдонимы: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
interface_descriptions list / элементы=dictionary	Параметры интерфейсов, заданные в политике параметров интерфейсов, будут применены к интерфейсам на идентификаторах узлов, указанных в `nodes`. Если при обновлении для этого параметра задан пустой список, все существующие описания интерфейсов будут очищены. API выдаст ошибку, если в списке есть повторяющиеся идентификаторы интерфейсов.
description string	Описание интерфейса.
interface_id string	Идентификатор интерфейса.
interfaces list / элементы=string	Имена интерфейсов, на которые будет развернута политика. При обновлении старое значение `interfaces` будет заменено новым значением `interfaces`.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании подключаемого модуля соединения HTTPAPI, если этот атрибут не указан, будет использована переменная инвентаря `ansible_httpapi_login_domain`.
name псевдонимы: physical_interface string	Имя физического интерфейса.
nodes list / элементы=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`.
physical_interface_type string	Тип группы политик интерфейсов. Варианты: `"physical"` `"breakout"`
physical_policy псевдонимы: policy, interface_policy, interface_policy_group, interface_setting dictionary	Политика группы интерфейсов, необходимая для политики настроек физического интерфейса. Этот параметр обязателен, если `physical_interface_type` равно `physical`. Этот параметр можно использовать вместо `physical_policy_uuid`.
name string	Имя политики настроек интерфейса.
template string	Имя шаблона, в котором указана политика настроек интерфейса.
physical_policy_uuid псевдонимы: policy_uuid, interface_policy_uuid, interface_policy_group_uuid, interface_setting_uuid string	UUID политики настроек интерфейса. Этот параметр необходим только при создании новой политики настроек интерфейса. Этот параметр обязателен, если `physical_interface_type` равно `physical`. Этот параметр можно использовать вместо `physical_policy`.
port integer	Номер порта для REST-соединения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PORT`.
state string	Для удаления используйте `absent`. Для отображения одного или нескольких объектов используйте `query`. Для создания или обновления используйте `present`. Варианты: `"absent"` `"query"` ← (по умолчанию) `"present"`
template string / обязательный	Имя шаблона. Шаблон должен быть шаблоном политик ресурсов фабрики.
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 псевдонимы: physical_interface_uuid string	UUID физического интерфейса. Этот параметр обязателен, если требуется обновить `name`.
validate_certs boolean	Если значение равно `false`, сертификаты SSL не будут проверяться. Значение `false` следует задавать только на контролируемых вами сайтах, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

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

См. также

cisco.mso.ndo_template: Управление шаблонами в Cisco Nexus Dashboard Orchestrator (NDO).

Примеры

- name: Create a Physical Interface with physical_interface_type set to physical
  cisco.mso.ndo_physical_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    name: ansible_test_physical_interface_physical
    description: "Physical Interface for Ansible Test"
    nodes: [101, 102, 103-105]
    interfaces: "1/1"
    physical_interface_type: physical
    physical_policy: ansible_test_interface_setting_policy_uuid
    state: present
  register: create_physical_interface_type_physical

- name: Create a Physical Interface with physical_interface_type set to breakout
  cisco.mso.ndo_physical_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    name: ansible_test_physical_interface_breakout
    description: "breakout interface for Ansible Test"
    nodes: [101, 102, 103-105]
    interfaces: "1/1"
    physical_interface_type: breakout
    breakout_mode: 4x25G
    interface_descriptions:
      - interface_id: "1/1"
        description: "Interface description for 1/1"
    state: present
  register: create_physical_interface_type_breakout

- name: Query all physical interfaces
  cisco.mso.ndo_physical_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    state: query
  register: query_all

- name: Query a specific Physical Interface with name
  cisco.mso.ndo_physical_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    name: ansible_test_physical_interface_physical
    state: query
  register: query_one_name

- name: Query a specific Physical Interface with UUID
  cisco.mso.ndo_physical_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    uuid: "{{ create_physical_interface_type_breakout.current.uuid }}"
    state: query
  register: query_one_uuid

- name: Delete a Physical Interface with name
  cisco.mso.ndo_physical_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    name: ansible_test_physical_interface_physical
    state: absent

- name: Delete a Physical Interface with UUID
  cisco.mso.ndo_physical_interface:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    uuid: "{{ query_one_uuid.current.uuid }}"
    state: absent

Авторы

Anvitha Jain (@anvjain)

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

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