dellemc.openmanage.ome_template_network_vlan – Установка помеченных и непомеченных VLAN на сетевую карту по умолчанию, поддерживаемую шаблоном в OpenManage Enterprise
Примечание
Этот плагин является частью коллекции dellemc.openmanage (версия 3.0.0).
Для его установки используйте: ansible-galaxy collection install dellemc.openmanage.
Для использования в книге задач укажите: dellemc.openmanage.ome_template_network_vlan.
Добавлена в версии 2.0.0: коллекции dellemc.openmanage
Обзор
- Этот модуль позволяет настроить помеченные и непомеченные VLAN на сетевой карте по умолчанию, поддерживаемой шаблоном в OpenManage Enterprise.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.7.5
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| hostname строка / обязательно | IP-адрес или имя хоста цели. | ||
| nic_identifier строка / обязательно | Имя порта сетевой карты в шаблоне для настройки VLAN. | ||
| password строка / обязательно | Пароль пользователя цели. | ||
| port целое число | По умолчанию: 443 | Порт HTTPS цели. | |
| tagged_networks список / элементы=словарь | Список помеченных VLAN и соответствующих портов сетевых карт. | ||
| port целое число / обязательно | Номер порта сетевой карты помеченного VLAN. | ||
| tagged_network_ids список / элементы=целое число | Список идентификаторов помеченных VLAN. Введите [] для удаления помеченного VLAN с порта. Список tagged_network_ids объединяется со списком tagged_network_names при добавлении помеченных VLAN на порт. Для получения идентификатора VLAN-сети используйте API https://hostname/api/NetworkConfigurationService/Networks
| ||
| tagged_network_names список / элементы=строка | Список имен помеченных VLAN. Введите [] для удаления помеченного VLAN с порта. Список tagged_network_names объединяется со списком tagged_network_ids при добавлении помеченных VLAN на порт. | ||
| template_id целое число | Идентификатор шаблона. Взаимоисключительно с template_name. | ||
| template_name строка | Имя шаблона. Взаимоисключительно с template_id. | ||
| untagged_networks список / элементы=словарь | Список непомеченных сетей и соответствующих портов сетевых карт. | ||
| port целое число / обязательно | Номер порта сетевой карты непомеченного VLAN. | ||
| untagged_network_id целое число | Идентификатор непомеченного VLAN. Введите 0 для удаления непомеченного VLAN с порта. Этот параметр взаимоисключителен с untagged_network_name
Для получения идентификатора VLAN-сети используйте API https://hostname/api/NetworkConfigurationService/Networks
| ||
| untagged_network_name строка | Имя VLAN для непомеченного режима. Укажите 0 для удаления непомеченного режима для этого порта
Этот параметр взаимоисключителен с untagged_network_id
| ||
| username строка / обязательно | Имя пользователя цели. | ||
Примечания
Примечание
- Запустите этот модуль с системы, имеющей прямой доступ к DellEMC OpenManage Enterprise.
- Этот модуль не поддерживает
check_mode.
Примеры
---
- name: Add tagged or untagged VLANs to a template using VLAN ID and name
dellemc.openmanage.ome_template_network_vlan:
hostname: "192.168.0.1"
username: "username"
password: "password"
template_id: 78
nic_identifier: NIC Slot 4
untagged_networks:
- port: 1
untagged_network_id: 127656
- port: 2
untagged_network_name: vlan2
tagged_networks:
- port: 1
tagged_network_ids:
- 12767
- 12768
- port: 4
tagged_network_ids:
- 12767
- 12768
tagged_network_names:
- vlan3
- port: 2
tagged_network_names:
- vlan4
- vlan1
- name: Clear the tagged and untagged VLANs from a template
dellemc.openmanage.ome_template_network_vlan:
hostname: "192.168.0.1"
username: "username"
password: "password"
template_id: 78
nic_identifier: NIC Slot 4
untagged_networks:
# For removing the untagged VLANs for the port 1 and 2
- port: 1
untagged_network_id: 0
- port: 2
untagged_network_name: 0
tagged_networks:
# For removing the tagged VLANs for port 1, 4 and 2
- port: 1
tagged_network_ids: []
- port: 4
tagged_network_ids: []
tagged_network_names: []
- port: 2
tagged_network_names: []
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| error_info словарь | при ошибке HTTP | Подробности ошибки HTTP. Пример: {'error': {'@Message.ExtendedInfo': [{'Message': 'Не удалось выполнить запрос, так как TemplateId не существует или не применимо для URI ресурса.', 'MessageArgs': ['TemplateId'], 'MessageId': 'CGEN1004', 'RelatedProperties': [], 'Resolution': "Проверьте URI ресурса запроса. Обратитесь к Руководству пользователя OpenManage Enterprise-Modular для получения дополнительной информации о URI ресурса и его свойствах.", 'Severity': 'Критический'}], 'code': 'Base.1.0.GeneralError', 'message': 'Произошла общая ошибка. Для получения дополнительной информации см. ExtendedInfo.'}} |
| msg строка | всегда | Общий статус операции vlan шаблона. Пример: Настройки сети успешно применены к шаблону |
Авторы
- Jagadeesh N V(@jagadeeshnv)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/dellemc/openmanage/ome_template_network_vlan_module.html