dellemc.openmanage.ome_smart_fabric_uplink – Создать, изменить или удалить аплинк для ткани на OpenManage Enterprise Modular

Примечание

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

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

Для использования в книге задач укажите: dellemc.openmanage.ome_smart_fabric_uplink.

Новое в версии 2.1.0: dellemc.openmanage

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

Обзор

Этот модуль позволяет создавать, изменять или удалять аплинк для ткани.

Требования

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

python >= 2.7.17

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
description строка		Укажите краткое описание для создаваемого или изменяемого канала связи.
fabric_name строка / обязательно		Укажите fabric_name для той ткани, для которой настраивается канал связи.
hostname строка / обязательно		Целевой IP-адрес или имя хоста.
name строка / обязательно		Укажите имя канала связи, который необходимо изменить.
new_name строка		Укажите имя канала связи, который необходимо изменить.
password строка / обязательно		Пароль целевого пользователя.
port целое число	По умолчанию: 443	Целевой порт HTTPS.
primary_switch_ports список / элементы=строка		Слот IOM, который будет подключен к основному коммутатору. primary_switch_service_tag обязателен для этого параметра.
primary_switch_service_tag строка		Идентификатор сервиса основного коммутатора.
secondary_switch_ports список / элементы=строка		Слот IOM, который будет подключен к резервному коммутатору. secondary_switch_service_tag обязателен для этого параметра.
secondary_switch_service_tag строка		Идентификатор сервиса резервного коммутатора.
state строка	Варианты: present ← absent	`present` - Создает новый канал связи с указанным именем. - Изменяет существующий канал связи с указанным именем. `absent` – Удаляет канал связи с указанным именем. ВНИМАНИЕ Операция удаления может повлиять на сетевую инфраструктуру.
tagged_networks список / элементы=строка		VLAN, которые будут связаны с каналом связи имя.
ufd_enable строка	Варианты: Enabled Disabled	Добавление или удаление канала связи в группу обнаружения отказа каналов связи (UFD). Группа UFD определяет потерю связи с коммутатором вышестоящего уровня и уведомляет серверы, подключенные к коммутатору. При сбое канала связи коммутатор отключает соответствующие порты серверов нижестоящего уровня. После этого нижестоящие серверы могут выбрать альтернативные маршруты соединения, если таковые имеются. ВНИМАНИЕ Версия прошивки модуля ввода/вывода, выполняющего Fabric Manager, должна поддерживать эту функцию настройки. В противном случае создание канала связи будет успешным, с соответствующим сообщением об ошибке в ответе.
untagged_network строка		Укажите имя VLAN, который будет добавлен как немаркированный для канала связи.
uplink_type строка	Варианты: Ethernet FCoE FC Gateway FC Direct Attach Ethernet - No Spanning Tree	Укажите тип канала связи. ПРИМЕЧАНИЕ Тип канала связи нельзя изменить для существующего канала связи.
username строка / обязательно		Имя целевого пользователя.

Примечания

Примечание

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

Примеры

---
- name: Create an Uplink
  dellemc.openmanage.ome_smart_fabric_uplink:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    fabric_name: "fabric1"
    name: "uplink1"
    description: "CREATED from OMAM"
    uplink_type: "Ethernet"
    ufd_enable: "Enabled"
    primary_switch_service_tag: "ABC1234"
    primary_switch_ports:
      - ethernet1/1/13
      - ethernet1/1/14
    secondary_switch_service_tag: "XYZ1234"
    secondary_switch_ports:
      - ethernet1/1/13
      - ethernet1/1/14
    tagged_networks:
      - vlan1
      - vlan3
    untagged_network: vlan2
  tags: create_uplink

- name: Modify an existing uplink
  dellemc.openmanage.ome_smart_fabric_uplink:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    fabric_name: "fabric1"
    name: "uplink1"
    new_name: "uplink2"
    description: "Modified from OMAM"
    uplink_type: "Ethernet"
    ufd_enable: "Disabled"
    primary_switch_service_tag: "DEF1234"
    primary_switch_ports:
      - ethernet1/2/13
      - ethernet1/2/14
    secondary_switch_service_tag: "TUV1234"
    secondary_switch_ports:
      - ethernet1/2/13
      - ethernet1/2/14
    tagged_networks:
      - vlan11
      - vlan33
    untagged_network: vlan22
  tags: modify_uplink

- name: Delete an Uplink
  dellemc.openmanage.ome_smart_fabric_uplink:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: "absent"
    fabric_name: "fabric1"
    name: "uplink1"
  tags: delete_uplink

- name: Modify an Uplink name
  dellemc.openmanage.ome_smart_fabric_uplink:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    fabric_name: "fabric1"
    name: "uplink1"
    new_name: "uplink2"
  tags: modify_uplink_name

- name: Modify Uplink ports
  dellemc.openmanage.ome_smart_fabric_uplink:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    fabric_name: "fabric1"
    name: "uplink1"
    description: "uplink ports modified"
    primary_switch_service_tag: "ABC1234"
    primary_switch_ports:
      - ethernet1/1/6
      - ethernet1/1/7
    secondary_switch_service_tag: "XYZ1234"
    secondary_switch_ports:
      - ethernet1/1/9
      - ethernet1/1/10
  tags: modify_ports

- name: Modify Uplink networks
  dellemc.openmanage.ome_smart_fabric_uplink:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    fabric_name: "fabric1"
    name: "create1"
    description: "uplink networks modified"
    tagged_networks:
      - vlan4
  tags: modify_networks

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

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

Ключ	Возвращаемое значение	Описание
additional_info словарь	при state=present и наличии дополнительной информации в ответе.	Дополнительные детали операции с фабрикой. Пример: {'error': {'@Message.ExtendedInfo': [{'Message': 'Не удалось настроить режим обнаружения отказа канала связи на канале связи, так как версия прошивки модуля ввода/вывода, выполняющего Fabric Manager, не поддерживает функцию настройки.', 'MessageArgs': [], 'MessageId': 'CDEV7151', 'RelatedProperties': [], 'Resolution': "Обновите версию прошивки модуля ввода/вывода, выполняющего Fabric Manager, и повторите операцию. Сведения о рекомендуемых версиях прошивки модуля ввода/вывода см. в руководстве пользователя OpenManage Enterprise-Modular, доступном на сайте поддержки.", 'Severity': 'Informational'}], 'code': 'Base.1.0.GeneralError', 'message': 'Произошла общая ошибка. Дополнительную информацию см. в ExtendedInfo.'}}
error_info словарь	при ошибке HTTP	Подробности ошибки HTTP. Пример: {'error': {'@Message.ExtendedInfo': [{'Message': 'Не удалось выполнить запрос, так как ресурс URI не существует или не реализован.', 'MessageArgs': [], 'MessageId': 'CGEN1006', 'RelatedProperties': [], 'Resolution': "Проверьте ресурс URI запроса. Дополнительную информацию о ресурсе URI и его свойствах см. в руководстве пользователя OpenManage Enterprise-Modular.", 'Severity': 'Critical'}], 'code': 'Base.1.0.GeneralError', 'message': 'Произошла общая ошибка. Дополнительную информацию см. в ExtendedInfo.'}}
msg строка	всегда	Общий статус операции с каналом связи. Пример: Успешно изменён канал связи.
uplink_id строка	при state=present	Возвращает идентификатор при создании или изменении канала связи. Пример: ddc3d260-fd71-46a1-97f9-708e12345678

Авторы

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