модуль cisco.ucs.ucs_vlan_find — поиск VLAN в Cisco UCS Manager

Примечание

Этот модуль входит в коллекцию cisco.ucs (версия 1.16.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.ucs. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии playbook, укажите: cisco.ucs.ucs_vlan_find.

Краткое описание
Требования
Параметры
Примеры
Возвращаемые значения

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

Поиск VLAN в Cisco UCS Manager по различным критериям.

Требования

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

ucsmsdk

Параметры

Параметр	Комментарии
fabric string	Конфигурация фабрики для VLAN. Может принимать одно из следующих значений: common — VLAN применяется к обеим фабрикам и использует одинаковые параметры конфигурации в обоих случаях. A — VLAN применяется только к фабрике A. B — VLAN применяется только к фабрике B. Варианты: `"common"` ← (по умолчанию) `"A"` `"B"`
hostname string / обязательный	IP-адрес или имя хоста Cisco UCS Manager. Модули можно использовать с эмулятором платформы UCS https://cs.co/ucspe
password string / обязательный	Пароль для аутентификации в Cisco UCS Manager.
pattern string	Шаблон регулярного выражения для поиска в свойстве name класса fabricVlan. Этот параметр обязателен, если параметр `vlanid` не указан.
port integer	Номер порта для подключения (по умолчанию используется 443 для HTTPS и 80 для HTTP).
proxy string	Если use_proxy имеет значение no, указывает прокси-сервер для подключения, например ‘http://proxy.xy.z:8080’
use_proxy boolean	Если `no`, прокси-сервер, заданный системной переменной окружения, использоваться не будет. Варианты: `false` `true` ← (по умолчанию)
use_ssl boolean	Если `no`, вместо HTTPS-подключения, используемого по умолчанию, будет использоваться HTTP-подключение. Варианты: `false` `true` ← (по умолчанию)
username string	Имя пользователя для аутентификации в Cisco UCS Manager. По умолчанию: `"admin"`
vlanid string	Уникальный строковый идентификатор, назначенный VLAN. Идентификатор VLAN может быть в диапазоне от ‘1’ до ‘3967’ или от ‘4048’ до ‘4093’. Этот параметр обязателен, если параметр `pattern` не указан.

Примеры

- name: Get all vlans in fabric A
  cisco.ucs.ucs_vlan_find:
    hostname: 172.16.143.150
    username: admin
    password: password
    fabric: 'A'
    pattern: '.'
- name: Confirm if vlan 15 is present
  cisco.ucs.ucs_vlan_find:
    hostname: 172.16.143.150
    username: admin
    password: password
    vlanid: '15'

Возвращаемые значения

Общие возвращаемые значения описаны здесь; далее перечислены поля, уникальные для этого модуля:

Ключ	Описание
vlan_list list / elements=string	основные сведения о найденных VLAN Возвращается: при успешном выполнении Пример: `[{"id": "0", "name": "vlcloud1"}]`

Авторы

David Martinez (@dx0xm)
David Soper (@dsoper2)
John McDonough (@movinalot)
CiscoUcs (@CiscoUcs)

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

© 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/ucs/ucs_vlan_find_module.html