модуль dellemc.openmanage.ome_smart_fabric_uplink — создание, изменение или удаление восходящего соединения для фабрики в OpenManage Enterprise Modular

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

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

Чтобы установить её, используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.ome_smart_fabric_uplink.

Добавлено в dellemc.openmanage 2.1.0

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

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

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

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path path добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат центра сертификации, который будет использоваться для проверки.
description string	Краткое описание создаваемого или изменяемого восходящего соединения.
fabric_name string / обязательный	Укажите fabric_name фабрики, для которой настраивается восходящее соединение.
hostname string / обязательный	IP-адрес или имя узла OpenManage Enterprise Modular.
name string / обязательный	Укажите name восходящего соединения, которое нужно создать, изменить или удалить.
new_name string	Укажите новое значение new_name для восходящего соединения.
password string	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port integer	HTTPS-порт OpenManage Enterprise Modular. По умолчанию: `443`
primary_switch_ports list / elements=string	Слоты IOM, которые необходимо подключить к основному коммутатору. Для этого параметра обязательно указать primary_switch_service_tag.
primary_switch_service_tag string	Сервисный тег основного коммутатора.
secondary_switch_ports elements=string	Слоты IOM, которые необходимо подключить к дополнительному коммутатору. Для этого параметра обязательно указать secondary_switch_service_tag.
secondary_switch_service_tag string	Сервисный тег дополнительного коммутатора.
state string	`present` — Создаёт восходящее соединение с указанным name. — Изменяет существующее восходящее соединение с указанным name. `absent` — Удаляет восходящее соединение с указанным name. ПРЕДУПРЕЖДЕНИЕ Операция удаления может повлиять на сетевую инфраструктуру. Варианты: `"present"` ← (по умолчанию) `"absent"`
tagged_networks list / elements=string	Сети VLAN, связанные с восходящим соединением name.
timeout integer добавлено в dellemc.openmanage 5.0.0	Тайм-аут на уровне сокета в секундах. По умолчанию: `30`
ufd_enable string	Добавить восходящее соединение в группу Uplink Failure Detection (UFD) или удалить его из неё. Группа UFD обнаруживает потерю связи с вышестоящим коммутатором и уведомляет серверы, подключённые к коммутатору. При сбое восходящего соединения коммутатор отключает соответствующие порты серверов, расположенные ниже по сети. После этого серверы могут выбрать альтернативные маршруты подключения, если они доступны. ПРЕДУПРЕЖДЕНИЕ Версия микропрограммы модуля ввода-вывода, на котором запущен Fabric Manager, должна поддерживать эту функцию конфигурации. В противном случае восходящее соединение будет создано, а в ответе появится соответствующее сообщение об ошибке. Варианты: `"Enabled"` `"Disabled"`
untagged_network string	Укажите имя VLAN, которую нужно добавить к восходящему соединению как нетегированную.
uplink_type string	Укажите тип восходящего соединения. ПРИМЕЧАНИЕ Тип восходящего соединения нельзя изменить для уже существующего соединения. Варианты: `"Ethernet"` `"FCoE"` `"FC Gateway"` `"FC Direct Attach"` `"Ethernet - No Spanning Tree"`
username string	Имя пользователя OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=username
validate_certs boolean добавлено в dellemc.openmanage 5.0.0	Если задано `false`, SSL-сертификаты проверяться не будут. Настраивайте `false` только на контролируемых вами сайтах, где используются самоподписанные сертификаты. В версиях коллекции до `5.0.0` параметр validate_certs по умолчанию имеет значение `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token string добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

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

Примеры

---
- name: Create an Uplink
  dellemc.openmanage.ome_smart_fabric_uplink:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    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"
    ca_path: "/path/to/ca_cert.pem"
    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"
    ca_path: "/path/to/ca_cert.pem"
    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"
    ca_path: "/path/to/ca_cert.pem"
    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"
    ca_path: "/path/to/ca_cert.pem"
    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"
    ca_path: "/path/to/ca_cert.pem"
    state: "present"
    fabric_name: "fabric1"
    name: "create1"
    description: "uplink networks modified"
    tagged_networks:
      - vlan4
  tags: modify_networks

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

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

Ключ	Описание
additional_info dictionary	Дополнительные сведения об операции с фабрикой. Возвращается: если state=present и ответ содержит дополнительные сведения. Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to configure the Uplink Failure Detection mode on the uplink because the firmware version of the I/O Module running the Fabric Manager does not support the configuration feature.", "MessageArgs": [], "MessageId": "CDEV7151", "RelatedProperties": [], "Resolution": "Update the firmware version of the I/O Module running the Fabric Manager and retry the operation. For information about the recommended I/O Module firmware versions, see the OpenManage Enterprise-Modular User's Guide available on the support site.", "Severity": "Informational"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}
error_info dictionary	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the request because the resource URI does not exist or is not implemented.", "MessageArgs": [], "MessageId": "CGEN1006", "RelatedProperties": [], "Resolution": "Check the request resource URI. Refer to the OpenManage Enterprise-Modular User's Guide for more information about resource URI and its properties.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}
msg string	Общий статус операции с восходящим соединением. Возвращается: всегда Пример: `"Successfully modified the uplink."`
uplink_id string	Возвращает идентификатор созданного или изменённого восходящего соединения. Возвращается: если state=present Пример: `"ddc3d260-fd71-46a1-97f9-708e12345678"`

Авторы

Jagadeesh N V(@jagadeeshnv)

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

© 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/dellemc/openmanage/ome_smart_fabric_uplink_module.html