модуль cisco.mso.ndo_fex_device — управление устройствами FEX в 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_fex_device.

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

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

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

Требования

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

Multi Site Orchestrator v2.1 или более поздней версии

Параметры

Параметр	Описание
description string	Описание устройства FEX.
fex_id aliases: fex_device_id integer	Идентификатор FEX. Значение должно находиться в диапазоне 101–199. Этот параметр обязателен, если `state=present`.
host aliases: hostname string	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
interfaces list / elements=string	Имена интерфейсов, подключённых к устройству FEX. Этот параметр обязателен, если `state=present`.
login_domain string	Имя домена входа, используемого для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не задан, будет использоваться переменная инвентаря `ansible_httpapi_login_domain`.
name aliases: fex_device_name string	Имя устройства FEX.
nodes list / elements=string	Список идентификаторов узлов, на которых будет развёрнуто устройство FEX. Каждый элемент может быть идентификатором отдельного узла или диапазоном идентификаторов. Этот параметр обязателен, если `state=present`.
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	Имя шаблона. Шаблон должен быть шаблоном политики ресурсов фабрики. Необходимо указать этот параметр или `template_id`.
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`. Значение по умолчанию — `false` при использовании плагина подключения HTTPAPI (mso или nd) и `true` при использовании устаревшего способа подключения (только для mso). Варианты: `false` `true`
username string	Имя пользователя, используемое для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
uuid aliases: fex_device_uuid string	UUID устройства FEX. Этот параметр обязателен, если необходимо обновить `name`. При обновлении или запросе существующего устройства FEX этот параметр можно использовать вместо `name`.
validate_certs boolean	Если `false`, SSL-сертификаты проверяться не будут. Задавайте значение `false` только на контролируемых вами сайтах, использующих самоподписанные сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`

Примечания

Примечание

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

См. также

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

Примеры

- name: Create a FEX Device
  cisco.mso.ndo_fex_device:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    name: ansible_test_fex_device
    description: "FEX Device for Ansible"
    fex_id: 102
    nodes: [101, 102, 103-105]
    interfaces: ["1/1"]
    state: present
  register: create_fex_device

- name: Query a FEX Device by name
  cisco.mso.ndo_fex_device:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    name: ansible_fex_device
    state: query
  register: query_name

- name: Query a FEX Device by UUID
  cisco.mso.ndo_fex_device:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    uuid: '{{ create_fex_device.current.uuid }}'
    state: query
  register: query_uuid

- name: Query all FEX Devices
  cisco.mso.ndo_fex_device:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    state: query
  register: query_all

- name: Delete a FEX Device by name
  cisco.mso.ndo_fex_device:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    name: ansible_test_fex_device
    state: absent

- name: Delete a FEX Device by UUID
  cisco.mso.ndo_fex_device:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    template: ansible_test_template
    uuid: '{{ create_fex_device.current.uuid }}'
    state: absent

Авторы

Shreyas Srish (@shrsr)

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

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