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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 путь добавлен в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки.
description строка	Укажите краткое описание создаваемого или изменяемого канала.
fabric_name строка / обязательно	Укажите имя fabric_name фабрики, для которой настраивается канал.
hostname строка / обязательно	IP-адрес или имя хоста OpenManage Enterprise Modular.
name строка / обязательно	Укажите имя создаваемого, изменяемого или удаляемого канала.
new_name строка	Укажите новое имя для канала.
password строка	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=пароль
port целое число	Порт HTTPS OpenManage Enterprise Modular. По умолчанию: `443`
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ы, которые необходимо связать с каналом name.
timeout целое число добавлен в dellemc.openmanage 5.0.0	Таймаут уровня сокета в секундах. По умолчанию: `30`
ufd_enable строка	Добавление или удаление канала в группу обнаружения отказа канала (UFD). Группа UFD определяет потерю подключения к коммутатору вышележащего уровня и уведомляет серверы, подключенные к этому коммутатору. При отказе канала коммутатор отключает соответствующие порты серверов нижележащего уровня. Затем серверы нижележащего уровня могут выбрать альтернативные маршруты подключения, если они доступны. ПРЕДУПРЕЖДЕНИЕ Версия прошивки модуля ввода-вывода, на котором работает Fabric Manager, должна поддерживать эту функцию конфигурации. В противном случае создание канала будет выполнено успешно с соответствующим сообщением об ошибке в ответ. Варианты: `"Enabled"` `"Disabled"`
untagged_network строка	Укажите имя VLAN, который необходимо добавить как неупакованный к каналу.
uplink_type строка	Укажите тип канала. ПРИМЕЧАНИЕ Тип канала нельзя изменить для существующего канала. Варианты: `"Ethernet"` `"FCoE"` `"FC Gateway"` `"FC Direct Attach"` `"Ethernet - No Spanning Tree"`
username строка	Имя пользователя OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=имя_пользователя

validate_certs

boolean

added in dellemc.openmanage 5.0.0

Если false, сертификаты SSL не будут проверены.

Настраивайте false только на сайтах, находящихся под вашим контролем, где используются самозаверяющие сертификаты.

До версии коллекции 5.0.0, validate_certs false по умолчанию.

Варианты:

false
true ← (по умолчанию)

x_auth_token

string

added in 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 словарь	Дополнительные сведения об операции с Fabric. Возвращается: при 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 словарь	Подробности 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 строка	Общий статус операции с uplink. Возвращается: всегда Пример: `"Successfully modified the uplink."`
uplink_id строка	Возвращает ID при создании или изменении uplink. Возвращается: при state=present Пример: `"ddc3d260-fd71-46a1-97f9-708e12345678"`

Авторы

Jagadeesh N V(@jagadeeshnv)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/openmanage/ome_smart_fabric_uplink_module.html