dellemc.openmanage.ome_network_vlan – Создание, изменение и удаление VLAN

Примечание

Этот плагин входит в коллекцию dellemc.openmanage (версия 3.0.0).

Для его установки используйте: ansible-galaxy collection install dellemc.openmanage.

Для использования в плейбуке укажите: dellemc.openmanage.ome_network_vlan.

Новое в версии 2.1.0: плагина dellemc.openmanage

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль позволяет,
Создать VLAN в OpenManage Enterprise.
Изменить или удалить существующую VLAN в OpenManage Enterprise.

Требования

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

python >= 2.7.17

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
description строка		Краткое описание VLAN, который нужно создать или изменить.
hostname строка / обязательно		Целевой IP-адрес или имя хоста.
name строка / обязательно		Укажите имя VLAN, который нужно создать, удалить или изменить.
new_name строка		Укажите имя VLAN, который нужно изменить.
password строка / обязательно		Пароль целевого пользователя.
port целое число	По умолчанию: 443	Целевой порт HTTPS.
state строка	Варианты: present ← absent	`present` создает новую VLAN или изменяет существующую. `absent` удаляет существующую VLAN. ПРЕДУПРЕЖДЕНИЕ Удаление VLAN может повлиять на сетевую инфраструктуру.
type строка	Варианты: Общего назначения (Бронза) Общего назначения (Серебро) Общего назначения (Золото) Общего назначения (Платина) Интерсоединение кластеров Управление гипервизором Хранилище - iSCSI Хранилище - FCoE Хранилище - Репликация данных Миграция ВМ Регистрация событий FT VMWare	Типы поддерживаемых сетевых VLAN. Для описания каждого типа сети используйте API https://hostname/api/NetworkConfigurationService/NetworkTypes.
username строка / обязательно		Имя пользователя целевого пользователя.
vlan_maximum целое число		Максимальное значение VLAN в диапазоне. VLAN с одним значением создается, если vlan_maximum и vlan_minmum имеют одинаковые значения.
vlan_minimum целое число		Минимальное значение VLAN в диапазоне.

Примечания

Примечание

Выполняйте этот модуль с системы, которая имеет прямой доступ к DellEMC OpenManage Enterprise.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Create a VLAN range
  dellemc.openmanage.ome_network_vlan:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    state: present
    name: "vlan1"
    description: "VLAN desc"
    type: "General Purpose (Bronze)"
    vlan_minimum: 35
    vlan_maximum: 40
  tags: create_vlan_range

- name: Create a VLAN with a single value
  dellemc.openmanage.ome_network_vlan:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    state: present
    name: "vlan2"
    description: "VLAN desc"
    type: "General Purpose (Bronze)"
    vlan_minimum: 127
    vlan_maximum: 127
  tags: create_vlan_single

- name: Modify a VLAN
  dellemc.openmanage.ome_network_vlan:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    state: present
    name: "vlan1"
    new_name: "vlan_gold1"
    description: "new description"
    type: "General Purpose (Gold)"
    vlan_minimum: 45
    vlan_maximum: 50
  tags: modify_vlan

- name: Delete a VLAN
  dellemc.openmanage.ome_network_vlan:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    state: "absent"
    name: "vlan1"
  tags: delete_vlan

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

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

Ключ	Возвращаемое значение	Описание
error_info словарь	при ошибке HTTP	Подробности об ошибке HTTP. Пример: {'@Message.ExtendedInfo': [{'Message': 'Невозможно создать или обновить сеть, так как введённый минимальный VLAN 0 не входит в допустимый диапазон ( 1 - 4000 или 4021 - 4094 ).', 'MessageArgs': ['0', '1', '4000', '4021', '4094'], 'MessageId': 'CTEM1043', 'RelatedProperties': [], 'Resolution': 'Введите допустимый минимальный VLAN, как указано в сообщении, и повторите операцию.', 'Severity': 'Предупреждение'}], 'code': 'Base.1.0.GeneralError', 'message': 'Произошла общая ошибка. Для получения дополнительной информации см. ExtendedInfo.'}
msg строка	всегда	Общий статус операции VLAN. Пример: VLAN успешно создан.
vlan_status словарь	при state=present	Подробности VLAN, который был создан или изменён. Пример: {'@odata.context': '/api/$metadata#NetworkConfigurationService.Network', '@odata.id': '/api/NetworkConfigurationService/Networks(1234)', '@odata.type': '#NetworkConfigurationService.Network', 'CreatedBy': 'admin', 'CreationTime': '2020-01-01 05:54:36.113', 'Description': 'Описание VLAN', 'Id': 1234, 'InternalRefNWUUId': '6d6effcc-eca4-44bd-be07-1234ab5cd67e', 'Name': 'vlan1', 'Type': 1, 'UpdatedBy': None, 'UpdatedTime': '2020-01-01 05:54:36.113', 'VlanMaximum': 130, 'VlanMinimum': 140}

Авторы

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_network_vlan_module.html